Docs
Rechercher dans la documentation...⌘K

Aperçu SERP

API + MCP
GET/v3/rank-tracker/serp-overview

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

Paramètres de requête

top_positionsinteger

Nombre de positions SERP organiques les mieux classées à renvoyer. S’il n’est pas spécifié, toutes les positions disponibles seront renvoyées.

devicestringObligatoire

Choisissez entre les classements mobile et desktop.

Valeurs autorisées:desktopmobile
datestring

Horodatage auquel le dernier Aperçu SERP disponible est renvoyé, au format YYYY-MM-DDThh:mm:ss. S’il n’est pas spécifié, l’Aperçu SERP le plus récent est renvoyé.

location_idinteger

ID de localisation d'un mot-clé suivi. Vous pouvez utiliser le endpoint management/project-keywords pour obtenir les codes pays, les codes langue et les ID de localisation de vos mots-clés suivis.

countrystringObligatoire

Un code pays à deux lettres (ISO 3166-1 alpha-2).

Valeurs autorisées:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

Code langue d'un mot-clé suivi. Vous pouvez utiliser le endpoint management/project-keywords pour obtenir les codes pays, les codes langue et les ID de localisation de vos mots-clés suivis.

keywordstringObligatoire

Le mot-clé pour lequel renvoyer l’Aperçu SERP.

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#

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

positionsarray<object>
ahrefs_rankinteger or null

La force du profil de backlinks d'un domaine par rapport aux autres sites Web de notre base de données, le rang n°1 étant le plus fort.

backlinksinteger or null

Le nombre total de liens provenant d'autres sites Web pointant vers un résultat de recherche.

domain_ratingnumber or null

La force du profil de backlinks d'un domaine par rapport aux autres dans notre base de données, sur une échelle de 100 points.

keywordsinteger or null

Le nombre total de mots-clés pour lesquels un résultat de recherche se classe dans les 100 premières positions organiques.

nr_wordsinteger or null

Le nombre total de mots présents dans le code HTML d'une page Web.

page_typestring or null

Liste séparée par des virgules de chemins hiérarchiques de types de pages prédits par l’IA pour la page classée. Chaque valeur est un chemin préfixé par une barre oblique (p. ex. /Article/How_to).

positioninteger

La position du résultat de recherche dans la SERP.

refdomainsinteger or null

Le nombre total de domaines uniques liés à un résultat de recherche.

titlestring or null

Le titre d’une page classée.

top_keywordstring or null

Le mot-clé qui génère le plus de trafic organique vers un résultat de recherche.

top_keyword_volumeinteger or null

Une estimation du nombre mensuel moyen de recherches pour le mot-clé principal sur la base des données des 12 derniers mois connus.

trafficinteger or null

Une estimation du trafic mensuel de recherche organique qu’un résultat reçoit à partir de l’ensemble des mots-clés sur lesquels il est classé.

typearray<string>

Le type de position : organique, payée ou l’une des Fonctionnalités SERP. Valeurs autorisées : ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

La date à laquelle nous avons vérifié les résultats des moteurs de recherche pour un mot-clé.

urlstring or null

L’URL d’une page classée.

url_ratingnumber or null

La force du profil de backlinks d'une page sur une échelle logarithmique de 100 points.

valueinteger or null

La valeur estimée du trafic de recherche organique mensuel d’une page, en cents de dollar américain (USD).