Docs
Rechercher dans la documentation...⌘K

Aperçu

API + MCP
GET/v3/rank-tracker/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

Date pour laquelle générer 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:jsoncsvxmlphp

Réponses

overviewsarray<object>
best_position_has_thumbnailboolean or null

La meilleure position (ou celle de l’URL cible, si définie) a une vignette.

best_position_has_thumbnail_previousboolean or null

La meilleure position (ou celle de l’URL cible, si définie) avait une vignette à la date de comparaison.

best_position_has_video_previewboolean or null

La meilleure position (ou celle de l’URL cible, si définie) a un aperçu vidéo.

best_position_has_video_preview_previousboolean or null

La meilleure position (ou celle de l’URL cible, si définie) avait un aperçu vidéo à la date de comparaison.

best_position_kindstring or null

Le type de meilleure position (ou celui de l’URL cible, si définie) : organique, payante ou une fonctionnalité SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_previousstring or null

Le type de meilleure position (ou d’URL cibles, si définies) à la date de comparaison.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

La mesure des clics fait référence au nombre mensuel moyen de clics sur les résultats de recherche effectués par les internautes lors de la recherche du mot-clé ciblé. Certaines recherches génèrent des clics sur plusieurs résultats, tandis que d'autres peuvent n'aboutir à aucun clic.

clicks_per_searchnumber (float) or null

Les clics par recherche correspondent au rapport entre les clics et le volume de recherche par mot-clé. Il indique le nombre de résultats de recherche différents sur lesquels les internautes cliquent, en moyenne, lorsque des personnes recherchent le mot-clé ciblé dans un pays donné.

cost_per_clickinteger or null

Le coût par clic indique le prix moyen que les annonceurs paient pour chaque clic sur une annonce dans les résultats de recherche payante pour un mot-clé.

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

La date à laquelle un mot-clé a été ajouté au projet.

is_brandedboolean

Intention de l'utilisateur : de marque. L'utilisateur recherche une marque ou un nom d'entreprise spécifique.

is_commercialboolean

Intention de l'utilisateur : commerciale. L'utilisateur compare des produits ou des services avant de prendre une décision d'achat.

is_informationalboolean

Intention de l'utilisateur : informationnel. L'utilisateur recherche des informations ou une réponse à une question spécifique.

is_localboolean

Intention de l'utilisateur : local. L'utilisateur recherche des informations pertinentes relatives à un emplacement spécifique ou à des services à proximité.

is_navigationalboolean

Intention de l'utilisateur : navigationnel. L'utilisateur recherche un site web ou une page web spécifique.

is_transactionalboolean

Intention de l'utilisateur : transactionnel. L'utilisateur est prêt à effectuer une action, souvent un achat.

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.

keyword_prevstring

Le mot-clé pour lequel votre cible se classe à la date de comparaison.

languagestring

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

language_prevstring

La langue de la SERP à la date de comparaison.

locationstring

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

location_prevstring

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

parent_topicstring or null

Le sujet parent détermine si vous pouvez vous classer pour votre mot-clé cible tout en ciblant un sujet plus général sur votre page à la place. Pour identifier le sujet parent, nous prenons la page de classement n°1 pour votre mot-clé et trouvons le mot-clé responsable de l'envoi du plus de trafic vers cette page.

positioninteger or null

La meilleure position (ou les URL cibles, si définies) dans la recherche organique.

position_diffinteger or null

La variation de la meilleure position (ou des URL cibles, si définies) entre les dates sélectionnées.

position_previnteger or null

La meilleure position (ou les URL cibles, si définies) à la date de comparaison.

search_type_imagenumber (float) or null

Le type de recherche Image montre le pourcentage de recherches pour un mot-clé effectuées pour des images, soulignant l'intérêt pour le contenu visuel.

search_type_newsnumber (float) or null

Le type de recherche Actualités indique le pourcentage de recherches pour un mot-clé effectuées pour des articles d'actualité.

search_type_videonumber (float) or null

Le type de recherche Vidéo indique le pourcentage de recherches pour un mot-clé effectué pour la vidéo, reflétant l'intérêt pour le contenu vidéo.

search_type_webnumber (float) or null

Le type de recherche Web indique le pourcentage de recherches pour un mot-clé effectuées pour du contenu Web général, indiquant un intérêt pour un large éventail d'informations.

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_features_prevarray<string>

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

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

tags_prevarray<string>

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

target_positions_countinteger

Le nombre d’URL cibles classées pour un mot-clé.

trafficinteger or null

Une estimation du nombre de visites mensuelles qu’une page reçoit via la recherche organique sur le dernier mois, ou sur les 12 derniers mois de données disponibles, selon le paramètre « volume_mode ».

traffic_diffinteger or null

Le changement de trafic entre vos dates sélectionnées.

traffic_previnteger or null

Une estimation du nombre de visites mensuelles qu’une page reçoit via la recherche organique sur le dernier mois, ou sur les 12 derniers mois de données disponibles, selon le paramètre « volume_mode ».

urlstring (url) or null

L’URL la mieux classée (ou l’URL cible, si elle est définie) en recherche organique.

url_prevstring (url) or null

L’URL la mieux classée (ou l’URL cible, si elle est définie) à la date de comparaison.

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

volume_desktop_pctnumber (float) or null

Le pourcentage du volume de recherche total provenant des appareils de bureau.

volume_mobile_pctnumber (float) or null

Le pourcentage du volume de recherche total provenant des appareils mobiles.