Docs
Rechercher dans la documentation...⌘K

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

selectstringObligatoire

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

date_comparedstring (date)

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

datestring (date)Obligatoire

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 (date-time) or null

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

serp_updated_prevstring (date-time) 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 ».