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).

cpc
type: integer nullable

cpc_prev: La metrica CPC alla data di confronto.
type: integer nullable

has_thumbnail: La posizione ha una miniatura.
type: boolean

has_thumbnail_prev: La posizione aveva una miniatura alla data di confronto.
type: boolean

has_video: La posizione ha un video.
type: boolean

has_video_prev: La posizione aveva un video alla data di confronto.
type: boolean

keyword: La parola chiave per cui il tuo target si posiziona.
type: string

keyword_difficulty (10 units): Una stima di quanto sia difficile posizionarsi nella top 10 dei risultati di ricerca organici per una parola chiave su una scala da 100 punti.
type: integer nullable

keyword_difficulty_prev (10 units): La Keyword Difficulty alla data di confronto.
type: integer nullable

keyword_prev: La parola chiave per cui il tuo target si posizionava alla data di confronto.
type: string

keywords: Il numero totale di parole chiave per cui il tuo target si posiziona tra le prime 100 posizioni della ricerca organica.
type: integer

keywords_diff: La variazione nelle parole chiave tra le date selezionate.
type: integer

keywords_diff_percent: La variazione nelle parole chiave tra le date selezionate, in percentuale.
type: integer

keywords_merged: Il totale delle parole chiave ottimizzato per l'ordinamento.
type: integer

keywords_prev: La parola chiave per cui il tuo target si posizionava alla data di confronto.
type: integer

page_type: Elenco separato da virgole di percorsi gerarchici di tipologia pagina previsti dall'IA. Ogni valore è un percorso con prefisso slash (es. /Article/How_to).
type: string nullable

position: La posizione per cui il tuo target si posiziona nei risultati di ricerca organici per una parola chiave.
type: integer

position_kind: Il tipo di una posizione: organica, a pagamento o una funzionalità SERP. Questo si applica a tutte le posizioni per una determinata parola chiave e URL prima di selezionare la migliore posizione.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_kind_prev: Il tipo di una posizione alla data di confronto.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_prev: La posizione del tuo target per una determinata parola chiave alla data di confronto.
type: integer

raw_url: L'URL della pagina in ranking in formato codificato.
type: string

raw_url_prev: L'URL della pagina in ranking alla data di confronto in formato codificato.
type: string

referring_domains (5 units): Il numero di domini unici che si collegano a una pagina.
type: integer nullable

serp_features
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_prev: Le funzionalità SERP alla data di confronto.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

status: Lo stato di una pagina: la nuova pagina che ha iniziato a posizionarsi ("left"), la pagina persa che è scomparsa dai risultati di ricerca ("right") oppure nessuna variazione ("both").
type: string
enum: "left" "right" "both"

sum_traffic (10 units): Una stima del traffico di ricerca organica mensile che una pagina ottiene da tutte le parole chiave per cui si posiziona.
type: integer nullable

sum_traffic_merged (10 units): Il campo del traffico ottimizzato per l'ordinamento.
type: integer

sum_traffic_prev (10 units): Il traffico alla data di confronto.
type: integer nullable

top_keyword: La parola chiave che porta più traffico organico a una pagina.
type: string nullable

top_keyword_best_position: La posizione in ranking che una pagina detiene per la sua parola chiave principale.
type: integer nullable

top_keyword_best_position_diff: La variazione della migliore posizione tra le date selezionate.
type: integer nullable

top_keyword_best_position_kind: Il tipo della migliore posizione: organica, a pagamento o una funzionalità SERP.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_kind_prev: Il tipo della migliore posizione alla data di confronto.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_prev: La migliore posizione alla data di confronto.
type: integer nullable

top_keyword_best_position_title: Il titolo visualizzato per la pagina nella SERP della sua parola chiave principale.
type: string nullable

top_keyword_best_position_title_prev: Il titolo visualizzato per la pagina nella SERP della sua parola chiave principale alla data di confronto.
type: string nullable

top_keyword_country: Il paese in cui una pagina si posiziona per la sua parola chiave principale.
type: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_country_prev: Il paese in cui una pagina si posizionava per la sua parola chiave principale alla data di confronto.
type: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_prev: La parola chiave che portava più traffico organico a una pagina alla data di confronto.
type: string nullable

top_keyword_volume (10 units): Una stima del numero medio mensile di ricerche per la parola chiave principale nell'ultimo mese o negli ultimi 12 mesi di dati conosciuti, in base al parametro "volume_mode".
type: integer nullable

top_keyword_volume_prev (10 units): Il volume di ricerca alla data di confronto.
type: integer nullable

traffic (10 units): Una stima del numero di visitatori mensili che il tuo target ottiene dalla ricerca organica per una parola chiave.
type: integer

traffic_diff: La variazione del traffico tra le date selezionate.
type: integer

traffic_diff_percent: La variazione del traffico tra le date selezionate, in percentuale.
type: integer

traffic_prev (10 units): Il traffico da una parola chiave alla data di confronto.
type: integer

ur: URL Rating (UR) mostra la forza del profilo di backlinks della pagina target su una scala logaritmica da 100 punti.
type: float nullable

url: L'URL della pagina in ranking.
type: url nullable

url_prev: L'URL della pagina in ranking alla data di confronto.
type: url nullable

value (10 units): Il valore stimato del traffico di ricerca organica mensile di una pagina, in centesimi di USD.
type: integer nullable

value_diff: La variazione del valore del traffico tra le date selezionate.
type: integer

value_diff_percent: La variazione del valore del traffico tra le date selezionate, in percentuale.
type: integer

value_merged (10 units): Il campo del valore del traffico ottimizzato per l'ordinamento.
type: integer nullable

value_prev (10 units): Il valore del traffico alla data di confronto.
type: integer nullable

volume (10 units): Una stima del numero di ricerche per una parola chiave nell'ultimo mese.
type: integer nullable

volume_prev (10 units): Il volume di ricerca alla data di confronto.
type: integer nullable

words: Il numero di parole in una parola chiave.
type: integer

words_prev: Il numero di parole in una parola chiave alla data di confronto.
type: integer

selectstringObbligatorio

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

protocolstring

Il protocollo del tuo target.

Valori consentiti:bothhttphttps

Predefinita:both

targetstringObbligatorio

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

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

datestringObbligatorio

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.

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.

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

L'URL della pagina in classifica.

url_prevstring 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.