Docs
Cerca nella documentazione...⌘K

Pagine principali

API + MCP
GET/v3/site-explorer/top-pages

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

pagesarray<object>
keywordsinteger or null

Il numero totale di parole chiave per le quali il tuo target si posiziona nei primi 100 risultati di ricerca organici.

keywords_diffinteger

La modifica delle parole chiave tra le date selezionate.

keywords_diff_percentinteger

La variazione delle parole chiave tra le date selezionate, in percentuale.

keywords_mergedinteger

Il numero totale di parole chiave ottimizzato per l’ordinamento.

keywords_previnteger or null

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

page_typestring or null

Elenco separato da virgole di percorsi gerarchici dei tipi di pagina previsti dall’IA. Ogni valore è un percorso con prefisso slash (es. /Article/How_to).

raw_urlstring

L'URL della pagina in classifica in formato codificato.

raw_url_prevstring or null

L'URL della pagina in classifica alla data di confronto in formato codificato.

referring_domainsinteger or null

(5 unità) Il numero di domini univoci che contengono un link a una pagina.

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_trafficinteger or null

(10 unità) Una stima del traffico di ricerca organica mensile che una pagina riceve da tutte le parole chiave per cui è posizionata.

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.

top_keywordstring or null

La parola chiave che porta la maggior parte del traffico organico a una pagina.

top_keyword_best_positioninteger or null

La posizione che una pagina detiene per la sua parola chiave principale.

top_keyword_best_position_diffinteger or null

La variazione nella posizione migliore tra le date selezionate.

top_keyword_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
top_keyword_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
top_keyword_best_position_previnteger or null

La posizione migliore alla data di confronto.

top_keyword_best_position_titlestring or null

Il titolo mostrato per la pagina nella SERP della sua Parola chiave principale.

top_keyword_best_position_title_prevstring or null

Il titolo mostrato per la pagina nella SERP della sua Parola chiave principale alla data di confronto.

top_keyword_countrystring or null

Il paese in cui una pagina si posiziona per la sua Parola chiave principale.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_country_prevstring or null

Il paese in cui una pagina si posiziona per la sua Parola chiave principale alla data di confronto.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_prevstring or null

La parola chiave che porta più traffico organico a una pagina alla data di confronto.

top_keyword_volumeinteger or null

(10 unità) Una stima del numero medio mensile di ricerche per la Parola chiave principale nell’ultimo mese o negli ultimi 12 mesi di dati disponibili, a seconda del parametro "volume_mode".

top_keyword_volume_previnteger or null

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

traffic_diffinteger

La variazione del traffico tra le date selezionate.

traffic_diff_percentinteger

La variazione del traffico tra le date selezionate, in percentuale.

urnumber (float) or null

L'URL Rating (UR) mostra la solidità del profilo di backlink della tua pagina di destinazione su una scala logaritmica a 100 punti.

urlstring (url) or null

L'URL della pagina in classifica.

url_prevstring (url) or null

L'URL della pagina in classifica alla data di confronto.

valueinteger or null

(10 unità) Il valore stimato del traffico di ricerca organico mensile di una pagina, in centesimi di USD.

value_diffinteger

La variazione del valore del traffico tra le date selezionate.

value_diff_percentinteger

La variazione del Valore del traffico tra le date selezionate, in percentuale.

value_mergedinteger or null

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

value_previnteger or null

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