Pagine a pagamento

API + MCP

GET/v3/site-explorer/paid-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).

ads_count: Il numero di annunci unici associati a una pagina.
type: integer

ads_count_diff: La variazione negli annunci tra le date selezionate.
type: integer

ads_count_prev: Il numero di annunci alla data di confronto.
type: integer

cpc
type: integer nullable

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

description: La descrizione di un annuncio così come appare nei risultati di ricerca.
type: string

description_prev: La descrizione di un annuncio alla data di confronto.
type: string

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 nei risultati di ricerca a pagamento.
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

position: La posizione per cui il tuo target si posiziona nei risultati di ricerca a pagamento 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 nei risultati a pagamento ("left"), la pagina persa che è scomparsa dai risultati a pagamento ("right") oppure nessuna variazione ("both").
type: string
enum: "left" "right" "both"

sum_traffic (10 units): Una stima del traffico di ricerca a pagamento 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 a pagamento ottimizzato per l'ordinamento.
type: integer

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

title: Il titolo di un annuncio così come appare nei risultati di ricerca.
type: string

title_prev: Il titolo di un annuncio alla data di confronto.
type: string

top_keyword: La parola chiave che porta più traffico a pagamento 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 a pagamento 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 a pagamento 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

url_visual: L'URL di un annuncio così come appare nei risultati di ricerca.
type: string

url_visual_prev: L'URL di un annuncio alla data di confronto.
type: string

value (10 units): Il costo stimato del traffico di ricerca a pagamento 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>

ads_countinteger or null

Il numero di annunci unici con una pagina.

ads_count_diffinteger

La variazione del numero di annunci tra le date selezionate.

ads_count_previnteger or null

Il numero di annunci alla data di confronto.

keywordsinteger or null

Il numero totale di parole chiave per le quali il tuo target si posiziona nei risultati di ricerca a pagamento.

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.

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 nei risultati a pagamento ("left"), la pagina persa che è scomparsa dai risultati a pagamento ("right"), oppure nessuna modifica ("both").

Allowed values:leftrightboth

sum_trafficinteger or null

(10 unità) Una stima del traffico di ricerca a pagamento mensile che una pagina riceve da tutte le parole chiave per cui si posiziona.

sum_traffic_mergedinteger

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

sum_traffic_previnteger or null

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

top_keywordstring or null

La parola chiave che porta la maggior parte del traffico a pagamento ad 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 il maggior traffico a pagamento 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 costo stimato del traffico di ricerca a pagamento 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.