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

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#

keywordstringObligatoire

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

language_codestring

Le code de langue d’un mot-clé suivi. Vous pouvez utiliser le point de terminaison management/project-keywords pour obtenir les codes pays, les codes de 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:adaeafagaialamaoarasatauawazba…
location_idinteger

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

datestring (date-time)

Un horodatage à partir duquel 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é.

devicestringObligatoire

Choisissez entre les classements mobile et desktop.

Valeurs autorisées:desktopmobile
top_positionsinteger

Le nombre de premières positions organiques de la SERP à renvoyer. S’il n’est pas spécifié, toutes les positions disponibles seront renvoyées.

outputstring

Le format de sortie.

Valeurs autorisées:jsonphpxml

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 (float) 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 (date)

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

urlstring (url) or null

L’URL d’une page classée.

url_ratingnumber (float) 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).