Docs
Cerca nella documentazione...⌘K

Panoramica SERP

API + MCP
GET/v3/rank-tracker/serp-overview

Le richieste a questo endpoint sono gratuite e non consumano alcuna unità API.

Parametri della query

top_positionsinteger

Il numero di posizioni SERP organiche principali da restituire. Se non specificato, verranno restituite tutte le posizioni disponibili.

devicestringObbligatorio

Scegli tra classifiche mobile e desktop.

Valori consentiti:desktopmobile
datestring

Un timestamp in base al quale viene restituita l’ultima Panoramica SERP disponibile, nel formato YYYY-MM-DDThh:mm:ss. Se non specificato, viene restituita la Panoramica SERP più recente.

location_idinteger

L'ID località di una keyword monitorata. Puoi usare l'endpoint management/project-keywords per ottenere codici paese, codici lingua e ID località per le keyword monitorate.

countrystringObbligatorio

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

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

Il codice lingua di una keyword monitorata. Puoi usare l'endpoint management/project-keywords per ottenere codici paese, codici lingua e ID località per le keyword monitorate.

keywordstringObbligatorio

La keyword per cui restituire la Panoramica SERP.

project_idintegerObbligatorio

L'identificatore univoco del progetto. Puoi trovarlo nell'URL del tuo progetto Rank Tracker in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

positionsarray<object>
ahrefs_rankinteger or null

La forza del profilo di backlink di un dominio rispetto agli altri siti web nel nostro database, con il primo posto in classifica come il più forte.

backlinksinteger or null

Il numero totale di link da altri siti web che puntano ad un risultato di ricerca.

domain_ratingnumber or null

La forza del profilo di backlink di un dominio rispetto agli altri nel nostro database su una scala a 100 punti.

keywordsinteger or null

Il numero di parole chiave per le quali questo risultato di ricerca si colloca nelle prime 100 posizioni.

nr_wordsinteger or null

Il numero totale di parole presenti nel codice HTML di una pagina web.

page_typestring or null

Elenco separato da virgole di percorsi gerarchici del tipo di pagina previsti dall'IA per la pagina in classifica. Ogni valore è un percorso con prefisso slash (ad es. /Article/How_to).

positioninteger

La posizione del risultato di ricerca nella SERP.

refdomainsinteger or null

Il numero totale di domini univoci collegati ad un risultato di ricerca.

titlestring or null

Il titolo di una pagina in classifica.

top_keywordstring or null

La parola chiave che porta più traffico più organico ad un risultato di ricerca.

top_keyword_volumeinteger or null

Una stima del numero medio mensile di ricerche per la parola chiave principale negli ultimi 12 mesi di dati.

trafficinteger or null

Una stima del traffico di ricerca organica mensile che un risultato riceve da tutte le parole chiave per cui si posiziona.

typearray<string>

Il tipo di posizione: organica, a pagamento o una funzionalità SERP. Valori consentiti: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

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

urlstring or null

L’URL di una pagina in classifica.

url_ratingnumber or null

La forza del profilo di backlink di una pagina su una scala logaritmica a 100 punti.

valueinteger or null

Il valore stimato del traffico di ricerca organico mensile di una pagina, in centesimi di USD.