Volume per Paese

API + MCP

GET/v3/keywords-explorer/volume-by-country

Parametri della query

selectstring

Un elenco di campi separati da virgole da restituire.

order_bystring

Un campo con cui ordinare i risultati, con direzione opzionale. Formato: field_name:asc o field_name:desc (predefinito desc).

Campi disponibili:

cpc
difficulty (10 units)
growth_rate_12m
traffic_potential (10 units)
volume (10 units)

limitinteger

Il numero di risultati da restituire.

offsetinteger

Il numero di risultati da saltare.

Predefinita:0

keyword_list_idinteger

L'ID di un elenco di parole chiave esistente.

keywordstring

Un elenco di parole chiave separate da virgole per le quali mostrare le metriche.

countriesstring

Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2), separati da virgole.

Valori consentiti:adaeafagaialamaoarasatauawazba…

volume_monthly_date_fromstring (date)

La data di inizio in formato AAAA-MM-GG per recuperare i volumi di ricerca mensili storici nel campo volume_monthly_history. Obbligatoria solo se viene richiesto volume_monthly_history.

volume_monthly_date_tostring (date)

La data di fine in formato AAAA-MM-GG per recuperare i volumi di ricerca mensili storici nel campo volume_monthly_history. Obbligatoria solo se è richiesto volume_monthly_history.

outputstring

Il formato di output.

Valori consentiti:jsonphp

Risposte

countriesarray<object>

countrystring

Un codice paese a due lettere (ISO 3166-1 alpha-2).

cpcinteger or null

Costo per clic di top_keyword, in centesimi di dollaro USA.

difficultyinteger or null

(10 units) Keyword Difficulty di top_keyword.

growth_rate_12mnumber (float) or null

Crescita del volume di ricerca negli ultimi dodici mesi. Disponibile per seed a keyword singola.

has_serpboolean or null

Se i dati SERP sono disponibili per top_keyword.

top_keywordstring or null

La keyword seed con il volume di ricerca più alto in questo paese.

top_pagestring or null

La migliore pagina organica per top_keyword.

top_page_titlestring or null

Titolo di top_page.

traffic_potentialinteger or null

(10 units) Potenziale di traffico di top_keyword.

volumeinteger

(10 unità) Una stima del numero medio mensile di ricerche per una parola chiave in un determinato Paese.

volume_monthly_historyarray<object>

(50 units) Volumi di ricerca mensili sommati sulle keyword seed in questo paese.

datestring (date)

volumeinteger

{ "countries": [ { "country": "string", "cpc": 0, "difficulty": 0, "growth_rate_12m": 0, "has_serp": true, "top_keyword": "string", "top_page": "string", "top_page_title": "string", "traffic_potential": 0, "volume": 0, "volume_monthly_history": [{ "date": "string", "volume": 0 }] } ] }