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

project_idintegerObbligatorio

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

keywordstringObbligatorio

La parola chiave per la quale restituire la panoramica SERP.

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 tue keyword monitorate.

countrystringObbligatorio

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

Valori consentiti:adaeafagaialamaoarasatauawazba…
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 tue keyword monitorate.

datestring (date-time)

Un timestamp che indica la data e l’ora per cui viene restituita l’ultima panoramica SERP disponibile, in formato YYYY-MM-DDThh:mm:ss. Se non è specificato, viene restituita la panoramica SERP più recente.

devicestringObbligatorio

Scegli tra classifiche mobile e desktop.

Valori consentiti:desktopmobile
top_positionsinteger

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

outputstring

Il formato di output.

Valori consentiti:jsonphpxml

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 (float) 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 (date)

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

urlstring (url) or null

L’URL di una pagina in classifica.

url_ratingnumber (float) 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.