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

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.

wherestring

L’expression de filtre. Les identifiants de colonne suivants sont reconnus (cela diffère des identifiants reconnus par le paramètre select).

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
limitinteger

Le nombre de résultats à renvoyer.

Par défaut:1000
timeoutinteger

Un délai d’expiration manuel, en secondes.

volume_modestring

Mode de calcul du volume de recherche : par mois ou en moyenne. Il influe sur le volume, le trafic et la valeur du trafic.

Valeurs autorisées:monthlyaverage
Par défaut:monthly
project_idintegerObligatoire

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

devicestringObligatoire

Choisissez entre les classements mobile et desktop.

Valeurs autorisées:desktopmobile
datestring (date)Obligatoire

Date pour laquelle rapporter les métriques, au format AAAA-MM-JJ.

date_comparedstring (date)

Une date avec laquelle comparer les métriques, au format AAAA-MM-JJ.

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

Valeurs autorisées:ADAEAFAGAIALAMAOAQARASATAUAWAX…
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é.

Valeurs autorisées:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
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 ».