Docs
Cerca nella documentazione...⌘K

Panoramica

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

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

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.

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.

devicestringObbligatorio

Scegli tra classifiche mobile e desktop.

Valori consentiti:desktopmobile
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#

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

overviewsarray<object>
best_position_has_thumbnailboolean or null

La posizione migliore (o quella dell’URL target, se impostato) ha una miniatura.

best_position_has_thumbnail_previousboolean or null

La posizione migliore (o quella dell’URL target, se impostato) aveva una miniatura alla data di confronto.

best_position_has_video_previewboolean or null

La posizione migliore (o quella dell’URL target, se impostato) ha un’anteprima video.

best_position_has_video_preview_previousboolean or null

La posizione migliore (o quella dell’URL target, se impostato) aveva un’anteprima video alla data di confronto.

best_position_kindstring or null

Il tipo di posizione migliore (o quella dell’URL target, se impostato): organica, a pagamento oppure una funzionalità SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_previousstring or null

Il tipo di posizione migliore (o di URL target, se impostati) alla data di confronto.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

La metrica Clic si riferisce al numero medio mensile di clic sui risultati di ricerca da parte degli utenti che cercano la parola chiave obiettivo. Alcune ricerche generano clic su più di un risultato, mentre altre potrebbero non comportare alcun clic.

clicks_per_searchnumber (float) or null

Clic per Ricerca è il rapporto tra il numero di clic e il volume di ricerca della parola chiave. Mostra quanti risultati di ricerca diversi ricevono un clic, in media, quando gli utenti cercano la parola chiave obiettivo in un determinato paese.

cost_per_clickinteger or null

Il Costo Per Clic mostra il prezzo medio che gli inserzionisti pagano per ogni clic su un annuncio nei risultati di ricerca a pagamento per una parola chiave.

countrystring

Il Paese in cui viene monitorata una determinata keyword. Un codice Paese di due lettere (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

Il Paese in cui viene monitorata una determinata keyword alla data di confronto. Un codice Paese di due lettere (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

La data in cui una parola chiave è stata aggiunta al progetto.

is_brandedboolean

Intento dell'utente: specifico del brand. L'utente sta cercando il nome di un marchio o di un'azienda specifica.

is_commercialboolean

Intento dell'utente: commerciale. L'utente confronta prodotti o servizi prima di prendere una decisione di acquisto.

is_informationalboolean

Intento dell'utente: informativo. L'utente sta cercando informazioni o una risposta a una domanda specifica.

is_localboolean

Intento dell'utente: locale. L'utente sta cercando informazioni riguardanti una posizione geografica specifica o servizi nelle vicinanze.

is_navigationalboolean

Intento dell'utente: di navigazione. L'utente sta cercando un sito o una pagina web specifica.

is_transactionalboolean

Intento dell'utente: transazionale. L'utente è pronto a completare un'azione, spesso un acquisto.

keywordstring

La parola chiave per la quale si posiziona il tuo target.

keyword_difficultyinteger or null

Una stima di quanto sia difficile posizionarsi tra i primi 10 risultati di ricerca organici per una parola chiave, su una scala a 100 punti.

keyword_has_databoolean

Restituirà false se la keyword è ancora in elaborazione e non è stata ancora recuperata alcuna SERP.

keyword_is_frozenboolean

Indica se una keyword ha superato il limite di keyword monitorate previsto dal tuo piano. Queste keyword sono "congelate", cioè non viene aggiornato il loro posizionamento.

keyword_prevstring

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

languagestring

La lingua della SERP per cui viene monitorata una determinata keyword.

language_prevstring

La lingua della SERP alla data di confronto.

locationstring

La località (Paese, stato/provincia o città) in cui viene monitorata una determinata keyword.

location_prevstring

La località (Paese, stato/provincia o città) in cui viene monitorata una determinata keyword alla data di confronto.

parent_topicstring or null

L'argomento principale determina se puoi posizionare la tua parola chiave target mentre scegli come target un argomento più generale sulla tua pagina. Per identificare l'argomento principale, prendiamo la pagina che si posiziona n. 1 per la tua parola chiave e troviamo la parola chiave responsabile dell'invio della maggior parte del traffico a quella pagina.

positioninteger or null

La posizione più alta (o gli URL target, se impostati) nella ricerca organica.

position_diffinteger or null

La variazione della posizione più alta (o degli URL target, se impostati) tra le date selezionate.

position_previnteger or null

La posizione più alta (o gli URL target, se impostati) alla data di confronto.

search_type_imagenumber (float) or null

Tipo di ricerca Immagine mostra la percentuale delle ricerche di una parola chiave effettuate per immagini, ed evidenzia l'interesse per i contenuti visivi.

search_type_newsnumber (float) or null

Tipo di ricerca Notizie mostra la percentuale di ricerche per una parola chiave effettuate per articoli di giornale.

search_type_videonumber (float) or null

Il tipo di ricerca Video mostra la percentuale di ricerche per una parola chiave effettuate per video, e rispecchia l'interesse per i contenuti video.

search_type_webnumber (float) or null

Tipo di ricerca Web mostra la percentuale di ricerche per una parola chiave effettuate per contenuti web generali, e indica l'interesse per una vasta gamma di informazioni.

serp_featuresarray<string>

Le funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

Le funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave alla data di confronto.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_updatedstring (date-time) or null

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

serp_updated_prevstring (date-time) or null

La data in cui abbiamo controllato i risultati del motore di ricerca fino alla data di confronto.

tagsarray<string>

Un elenco di tag assegnati a una determinata parola chiave.

tags_prevarray<string>

Un elenco di tag assegnati a una determinata parola chiave alla data di confronto.

target_positions_countinteger

Il numero di URL target posizionati per una parola chiave.

trafficinteger or null

Una stima del numero di visite mensili che una pagina riceve dalla ricerca organica nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".

traffic_diffinteger or null

La variazione del traffico tra le date selezionate.

traffic_previnteger or null

Una stima del numero di visite mensili che una pagina riceve dalla ricerca organica nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".

urlstring (url) or null

L’URL con il miglior posizionamento (o l’URL target, se impostato) nella ricerca organica.

url_prevstring (url) or null

L’URL con il miglior posizionamento (o l’URL target, se impostato) alla data di confronto.

volumeinteger or null

Una stima del numero medio mensile di ricerche per una parola chiave nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".

volume_desktop_pctnumber (float) or null

La percentuale del volume di ricerca totale che proviene da dispositivi desktop.

volume_mobile_pctnumber (float) or null

La percentuale del volume di ricerca totale che proviene da dispositivi mobili.