Docs
Cerca nella documentazione...⌘K

Parole chiave organiche

API + MCP
GET/v3/site-explorer/organic-keywords

Parametri della query

timeoutinteger

Una durata di timeout manuale in secondi.

limitinteger

Il numero di risultati da restituire.

Predefinita:1000
order_bystring

Un elenco di colonne separate da virgole per ordinare i risultati, con direzione facoltativa. Consulta lo schema di risposta per gli identificatori di colonna validi.

Example:field_a,field_b:asc,field_c:desc
wherestring

L'espressione del filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).

selectstringObbligatorio

Un elenco separato da virgole di colonne da restituire. Consulta lo schema della risposta per gli identificatori di colonna validi.

protocolstring

Il protocollo del tuo target.

Valori consentiti:bothhttphttps
Predefinita:both
targetstring (url)Obbligatorio

Il target della ricerca: un dominio o un URL.

modestring

L'ambito della ricerca in base al target inserito.

Valori consentiti:exactprefixdomainsubdomains
Predefinita:subdomains
countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

Una data con cui confrontare le metriche, in formato YYYY-MM-DD.

datestring (date)Obbligatorio

Una data per il Report delle metriche nel formato YYYY-MM-DD.

volume_modestring

La modalità di calcolo del Volume di ricerca: mensile o media. Influisce su volume, traffico e Valore del traffico.

Valori consentiti:monthlyaverage
Predefinita:monthly
outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

keywordsarray<object>
all_positionsarray<object>

(5 unità) L'elenco di tutte le posizioni per una parola chiave.

all_positions_prevarray<object>

(5 unità) L’elenco di tutte le posizioni per una parola chiave alla data di confronto.

best_positioninteger or null

La posizione migliore in cui il tuo target si classifica nei risultati di ricerca organici per una parola chiave.

best_position_diffinteger or null

Il cambio di posizione tra le date selezionate.

best_position_has_thumbnailboolean or null

La posizione migliore ha una miniatura.

best_position_has_thumbnail_prevboolean or null

La posizione migliore ha una miniatura alla data di confronto.

best_position_has_videoboolean or null

La posizione migliore ha un video.

best_position_has_video_prevboolean or null

La posizione migliore ha un video alla data di confronto.

best_position_kindstring or null

Il tipo della posizione migliore: organica, a pagamento o una funzionalità SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

Il tipo della posizione migliore ottimizzato per l’ordinamento.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

Il tipo della posizione migliore alla data di confronto.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

La posizione migliore alla data di confronto.

best_position_setstring

Il gruppo di ranking della posizione migliore.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

Il gruppo di ranking della posizione migliore alla data di confronto.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

L'URL in classifica nei risultati di ricerca organica.

best_position_url_prevstring (url) or null

L'URL in classifica alla data di confronto.

cpcinteger or null

Il Costo per clic mostra il prezzo medio che gli inserzionisti pagano per ogni clic su un annuncio nei risultati di ricerca a pagamento per una parola chiave, in centesimi di dollaro USA.

cpc_mergedinteger or null

Il campo CPC ottimizzato per l'ordinamento.

cpc_previnteger or null

La metrica CPC alla data di confronto.

entitiesarray<object>

Organizzazioni, prodotti, persone, opere, eventi e località trovati in una parola chiave.

is_best_position_set_top_11_50boolean

Il gruppo di posizionamento della posizione migliore è 11-50.

is_best_position_set_top_11_50_prevboolean or null

Il gruppo di posizionamento della posizione migliore era 11-50 alla data di confronto.

is_best_position_set_top_3boolean

Il gruppo di posizionamento della posizione migliore è Top 3.

is_best_position_set_top_3_prevboolean or null

Il gruppo di posizionamento della posizione migliore era Top 3 alla data di confronto.

is_best_position_set_top_4_10boolean

Il gruppo di posizionamento della posizione migliore è 4-10.

is_best_position_set_top_4_10_prevboolean or null

Il gruppo di posizionamento della posizione migliore era 4-10 alla data di confronto.

is_brandedboolean

Intento dell'utente: specifico del brand. L'utente sta cercando il nome di un marchio o di un'azienda specifica.

is_commercialboolean

Intento dell'utente: commerciale. L'utente confronta prodotti o servizi prima di prendere una decisione di acquisto.

is_informationalboolean

Intento dell'utente: informativo. L'utente sta cercando informazioni o una risposta a una domanda specifica.

is_localboolean

Intento dell'utente: locale. L'utente sta cercando informazioni riguardanti una posizione geografica specifica o servizi nelle vicinanze.

is_navigationalboolean

Intento dell'utente: di navigazione. L'utente sta cercando un sito o una pagina web specifica.

is_transactionalboolean

Intento dell'utente: transazionale. L'utente è pronto a completare un'azione, spesso un acquisto.

keywordstring or null

La parola chiave per la quale si posiziona il tuo target.

keyword_countrystring

Il paese della parola chiave per la quale si posiziona il tuo target.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_difficultyinteger or null

(10 unità) Stima di quanto sia difficile posizionarsi tra i primi 10 risultati di ricerca organici per una parola chiave su una scala di 100 punti.

keyword_difficulty_mergedinteger or null

(10 unità) Il campo Keyword Difficulty ottimizzato per l'ordinamento.

keyword_difficulty_previnteger or null

(10 unità) La Keyword Difficulty alla data di confronto.

keyword_languagearray<string>

La lingua della query di ricerca

keyword_mergedstring

Il campo della parola chiave ottimizzato per l'ordinamento.

keyword_prevstring or null

La parola chiave per la quale si posiziona il tuo target alla data di confronto.

languagestring

La lingua della SERP.

language_prevstring or null

La lingua della SERP alla data di confronto.

last_updatestring (date-time)

La data in cui abbiamo controllato per l'ultima volta i risultati del motore di ricerca per una parola chiave.

last_update_prevstring (date-time) or null

La data in cui abbiamo controllato i risultati del motore di ricerca fino alla data di confronto.

serp_featuresarray<string>

Le funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_countinteger

Il numero di funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave.

serp_features_count_previnteger or null

Il numero di funzionalità SERP alla data di confronto.

serp_features_mergedarray<string>

Il campo delle funzionalità SERP ottimizzato per l'ordinamento.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

Le funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave alla data di confronto.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_target_main_positions_countinteger

Il numero di URL target posizionati per una parola chiave, escludendo le posizioni in Sitelink, Top stories, Image packs e i post su X (Twitter).

serp_target_main_positions_count_previnteger or null

Il numero di URL target posizionati per una parola chiave, escludendo le posizioni in Sitelink, Top stories, Image packs e i post su X (Twitter) alla data di confronto.

serp_target_positions_countinteger

Il numero di URL target posizionati per una parola chiave.

serp_target_positions_count_previnteger or null

Il numero di URL target posizionati per una parola chiave alla data di confronto.

statusstring

Lo stato di una pagina: la nuova pagina che ha appena iniziato a posizionarsi ("left"), la pagina persa che è scomparsa dai risultati di ricerca ("right") oppure nessun cambiamento ("both").

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10 unità) Una stima del numero di visite mensili che il tuo target riceve dalla ricerca a pagamento di una parola chiave.

sum_paid_traffic_mergedinteger

(10 unità) Il campo del traffico a pagamento ottimizzato per l'ordinamento.

sum_paid_traffic_previnteger or null

(10 unità) Il traffico a pagamento alla data di confronto.

sum_trafficinteger or null

(10 unità) Una stima del numero di visite mensili che il tuo target riceve dalla ricerca organica per una parola chiave.

sum_traffic_mergedinteger

(10 unità) Il campo del traffico ottimizzato per l'ordinamento.

sum_traffic_previnteger or null

(10 unità) Il traffico alla data di confronto.

volumeinteger or null

(10 unità) Una stima del numero di ricerche per una parola chiave nell'ultimo mese.

volume_desktop_pctnumber (float) or null

La percentuale del volume di ricerca totale che proviene da dispositivi desktop.

volume_mergedinteger or null

(10 unità) Il campo del volume di ricerca ottimizzato per l'ordinamento.

volume_mobile_pctnumber (float) or null

La percentuale del volume di ricerca totale che proviene da dispositivi mobili.

volume_previnteger or null

(10 unità) Il volume di ricerca alla data di confronto.

wordsinteger or null

Il numero di parole in una parola chiave.

words_mergedinteger

Il numero di parole in una parola chiave ottimizzato per l'ordinamento.

words_previnteger or null

Il numero di parole in una parola chiave alla data di confronto.