Vue d'ensemble des concurrents

API + MCP

GET/v3/rank-tracker/competitors-overview

Les requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.

Paramètres de requête

timeoutinteger

Durée de délai d’attente manuelle, en secondes.

limitinteger

Nombre de résultats à renvoyer.

Par défaut:1000

order_bystring

Une liste de colonnes séparées par des virgules pour trier les résultats, avec un sens de tri facultatif. Consultez le schéma de réponse pour connaître les identifiants de colonne valides.

Example:field_a,field_b:asc,field_c:desc

wherestring

Expression de filtre. Les identifiants de colonnes suivants sont reconnus (ceux-ci diffèrent des identifiants reconnus par le paramètre select).

country: Le pays dans lequel un mot-clé est suivi. Code pays à deux lettres (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: Exclut les positions dans AI Overview, Sitelinks, Top stories, packs d’images, vidéos, discussions et forums, ainsi que les publications sur X (Twitter).
type: boolean

is_main_position_prev: Exclut les positions dans AI Overview, Sitelinks, Top stories, packs d’images, vidéos, discussions et forums, ainsi que les publications sur X (Twitter) à la date de comparaison.
type: boolean

keyword: Le mot-clé sur lequel votre cible se positionne.
type: string

keyword_difficulty: Estimation de la difficulté à se classer dans le top 10 des résultats de recherche organiques pour un mot-clé, sur une échelle de 100 points.
type: integer nullable

keyword_has_data: Renvoie false si le mot-clé est encore en cours de traitement et qu’aucune SERP n’a encore été récupérée.
type: boolean

keyword_is_frozen: Indique si un mot-clé a dépassé la limite de mots-clés suivis de votre offre. Ces mots-clés sont « gelés », ce qui signifie que leurs positions ne sont plus mises à jour.
type: boolean

language: Langue de la SERP pour laquelle un mot-clé est suivi.
type: string

location: Localisation (pays, État/province ou ville) dans laquelle un mot-clé est suivi.
type: string

serp_features: Les Fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé.
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: Date à laquelle nous avons vérifié pour la dernière fois les résultats du moteur de recherche pour un mot-clé.
type: datetime nullable

serp_updated_prev: Date à laquelle nous avons vérifié les résultats du moteur de recherche jusqu’à la date de comparaison.
type: datetime nullable

tags: Liste des tags attribués à un mot-clé.
type: array(string)

volume: Estimation du volume de recherche mensuel moyen pour un mot-clé sur le dernier mois, ou sur les 12 derniers mois de données connues selon le paramètre « volume_mode ».
type: integer nullable

selectstringObligatoire

Une liste de colonnes, séparées par des virgules, à renvoyer. Voir le Schéma de réponse pour les identifiants de colonne valides.

date_comparedstring

Une date avec laquelle comparer les métriques, au format YYYY-MM-DD.

datestringObligatoire

Une date pour laquelle établir un rapport sur les métriques, au format AAAA-MM-JJ.

devicestringObligatoire

Choisissez entre les classements mobile et desktop.

Valeurs autorisées:desktopmobile

project_idintegerObligatoire

L’identifiant unique du projet. Vous pouvez le trouver dans l’URL de votre projet Rank Tracker dans Ahrefs : https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

Mode de calcul du volume de recherche : mensuel ou moyen. Cela affecte le volume, le trafic et la valeur de trafic.

Valeurs autorisées:monthlyaverage

Par défaut:monthly

outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Réponses

keywordsarray<object>

competitors_listarray<object>

Informations sur les concurrents pour un mot-clé donné. Les champs suivants sont inclus : url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Les champs se terminant par prev ne sont inclus que dans la vue comparée.

countrystring

Le pays dans lequel un mot-clé donné est suivi. Code pays à deux lettres (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

keywordstring

Le mot-clé pour lequel votre cible se classe.

keyword_difficultyinteger or null

Une estimation de la difficulté à se classer dans les 10 premiers résultats de recherche organiques pour un mot-clé sur une échelle de 100 points.

keyword_has_databoolean

Renvoyera false si le mot-clé est toujours en cours de traitement et qu’aucune SERP n’a encore été récupérée.

keyword_is_frozenboolean

Indique si un mot-clé a dépassé la limite de mots-clés suivis de votre forfait. Ces mots-clés sont « gelés », ce qui signifie que leurs classements ne sont pas mis à jour.

languagestring

La langue de la SERP pour laquelle un mot-clé donné est suivi.

locationstring

L’emplacement (pays, état/province ou ville) dans lequel un mot-clé donné est suivi.

serp_featuresarray<string>

Les fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

serp_updatedstring or null

Date de la dernière vérification des résultats des moteurs de recherche pour un mot-clé.

serp_updated_prevstring or null

La date à laquelle nous avons vérifié les résultats des moteurs de recherche jusqu’à la date de comparaison.

tagsarray<string>

Une liste de tags attribués à un mot-clé donné.

volumeinteger or null

Une estimation du nombre mensuel moyen de recherches pour un mot-clé sur le dernier mois, ou sur les 12 derniers mois de données disponibles, selon le paramètre « volume_mode ».