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

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

country: Il paese in cui viene monitorata una determinata keyword. Un codice paese di due lettere (ISO 3166-1 alpha-2).
type: string
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"

is_main_position: Esclude le posizioni in AI Overview, Sitelink, Top stories, Image pack, Video, Discussioni e forum e i post su X (Twitter).
type: boolean

is_main_position_prev: Esclude le posizioni in AI Overview, Sitelink, Top stories, Image pack, Video, Discussioni e forum e i post su X (Twitter) alla data di confronto.
type: boolean

keyword: La keyword per cui si posiziona il tuo target.
type: string

keyword_difficulty: Una stima, su una scala da 100 punti, di quanto sia difficile posizionarsi tra i primi 10 risultati organici per una keyword.
type: integer nullable

keyword_has_data: Restituisce false se la keyword è ancora in elaborazione e non è stata ancora recuperata alcuna SERP.
type: boolean

keyword_is_frozen: Indica se una keyword ha superato il limite di keyword monitorate previsto dal tuo piano. Queste keyword sono "congelate", cioè non vengono aggiornate nelle classifiche.
type: boolean

language: La lingua della SERP per cui viene monitorata una determinata keyword.
type: string

location: La località (paese, stato/provincia o città) in cui viene monitorata una determinata keyword.
type: string

serp_features: Le Funzionalità SERP che compaiono nei risultati di ricerca per una keyword.
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_updated: La data in cui abbiamo controllato l’ultima volta i risultati dei motori di ricerca per una keyword.
type: datetime nullable

serp_updated_prev: La data in cui abbiamo controllato i risultati dei motori di ricerca fino alla data di confronto.
type: datetime nullable

tags: Un elenco di tag assegnati a una determinata keyword.
type: array(string)

volume: Una stima del volume medio mensile di ricerche per una keyword nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
type: integer nullable

selectstringObbligatorio

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

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.

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: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).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

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.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

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