Docs
Cerca nella documentazione...⌘K

Panoramica dei concorrenti

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

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

Parametri della query

selectstringObbligatorio

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

wherestring

L’espressione del filtro. Sono riconosciuti i seguenti identificatori di colonna (che differiscono dagli identificatori riconosciuti dal parametro select).

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
limitinteger

Il numero di risultati da restituire.

Predefinita:1000
timeoutinteger

Un timeout manuale in secondi.

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
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#

devicestringObbligatorio

Scegli tra classifiche mobile e desktop.

Valori consentiti:desktopmobile
datestring (date)Obbligatorio

Una data per la quale generare un report delle metriche nel formato YYYY-MM-DD.

date_comparedstring (date)

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

outputstring

Il formato di output.

Valori consentiti:jsonphp

Risposte

keywordsarray<object>
competitors_listarray<object>

Informazioni sui concorrenti per una determinata parola chiave. Sono inclusi i seguenti campi: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. I campi che terminano con prev sono inclusi solo nella vista di confronto.

countrystring

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

Valori consentiti:ADAEAFAGAIALAMAOAQARASATAUAWAX…
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.

languagestring

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

locationstring

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

serp_featuresarray<string>

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

Valori consentiti:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
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.

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