Aperçu
API + MCPLes requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.
Paramètres de requête
Durée de délai d’attente manuelle, en secondes.
Nombre de résultats à renvoyer.
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.
Expression de filtre. Les identifiants de colonnes suivants sont reconnus (ceux-ci diffèrent des identifiants reconnus par le paramètre select).
best_position_has_thumbnail: La meilleure position (ou celle de l’URL cible, si définie) a une vignette.
type: boolean nullable
best_position_has_thumbnail_previous: La meilleure position (ou celle de l’URL cible, si définie) avait une vignette à la date de comparaison.
type: boolean nullable
best_position_has_video_preview: La meilleure position (ou celle de l’URL cible, si définie) a un aperçu vidéo.
type: boolean nullable
best_position_has_video_preview_previous: La meilleure position (ou celle de l’URL cible, si définie) avait un aperçu vidéo à la date de comparaison.
type: boolean nullable
best_position_kind: Le type de meilleure position (ou celui de l’URL cible, si définie) : organique, payante ou une fonctionnalité SERP.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_kind_previous: Le type de meilleure position (ou celui de l’URL cible, si définie) à la date de comparaison.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
clicks: L’indicateur Clics correspond au nombre mensuel moyen de clics sur les résultats de recherche générés lorsque les internautes recherchent le mot-clé cible. Certaines recherches génèrent des clics sur plusieurs résultats, tandis que d’autres peuvent ne générer aucun clic.
type: integer nullable
clicks_per_search: Clics par recherche est le ratio entre Clics et le Volume de recherche du mot-clé. Il indique, en moyenne, combien de résultats de recherche différents sont cliqués lorsque les internautes recherchent le mot-clé cible dans un pays donné.
type: float nullable
cost_per_click: Le Coût par clic indique le prix moyen payé par les annonceurs pour chaque clic sur une annonce dans les résultats de recherche payants pour un mot-clé.
type: integer nullable
country: Le pays dans lequel un mot-clé est suivi. Code pays à deux lettres (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
country_prev: Le pays dans lequel un mot-clé était suivi à la date de comparaison. Code pays à deux lettres (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
created_at: Date d’ajout d’un mot-clé au Projet.
type: datetime
is_branded: Intention de recherche : de marque. L’utilisateur recherche une marque spécifique ou le nom d’une entreprise.
type: boolean
is_commercial: Intention de recherche : commerciale. L’utilisateur compare des produits ou des services avant de prendre une décision d’achat.
type: boolean
is_informational: Intention de recherche : informationnelle. L’utilisateur cherche des informations ou une réponse à une question précise.
type: boolean
is_local: Intention de recherche : locale. L’utilisateur cherche des informations liées à un lieu spécifique ou à des services à proximité.
type: boolean
is_main_position: Exclut les positions dans AI Overview, Sitelinks, Top stories, packs d’images, vidéos, discussions et forums, ainsi que les publications sur X (Twitter).
type: boolean
is_main_position_prev: Exclut les positions dans AI Overview, Sitelinks, Top stories, packs d’images, vidéos, discussions et forums, ainsi que les publications sur X (Twitter) à la date de comparaison.
type: boolean
is_navigational: Intention de recherche : navigationnelle. L’utilisateur recherche un site web ou une page web spécifique.
type: boolean
is_transactional: Intention de recherche : transactionnelle. L’utilisateur est prêt à effectuer une action, souvent un achat.
type: boolean
keyword: Le mot-clé sur lequel votre cible se positionne.
type: string
keyword_difficulty: Estimation de la difficulté à se classer dans le top 10 des résultats de recherche organiques pour un mot-clé, sur une échelle de 100 points.
type: integer nullable
keyword_has_data: Renvoie false si le mot-clé est encore en cours de traitement et qu’aucune SERP n’a encore été récupérée.
type: boolean
keyword_is_frozen: Indique si un mot-clé a dépassé la limite de mots-clés suivis de votre offre. Ces mots-clés sont « gelés », ce qui signifie que leurs positions ne sont plus mises à jour.
type: boolean
keyword_prev: Le mot-clé sur lequel votre cible se positionnait à la date de comparaison.
type: string
keyword_words: Nombre de mots dans un mot-clé.
type: integer
keyword_words_prev: Nombre de mots dans un mot-clé à la date de comparaison.
type: integer
language: Langue de la SERP pour laquelle un mot-clé est suivi.
type: string
language_prev: Langue de la SERP à la date de comparaison.
type: string
location: Localisation (pays, État/province ou ville) dans laquelle un mot-clé est suivi.
type: string
location_prev: Localisation (pays, État/province ou ville) dans laquelle un mot-clé était suivi à la date de comparaison.
type: string
parent_topic: Sujet parent détermine si vous pouvez vous classer sur votre mot-clé cible tout en visant à la place un sujet plus général sur votre page. Pour identifier le Sujet parent, nous prenons la page classée n°1 pour votre mot-clé et trouvons le mot-clé qui génère le plus de trafic vers cette page.
type: string nullable
position: La meilleure position (ou celle de l’URL cible, si définie) en recherche organique.
type: integer nullable
position_diff: La variation de la meilleure position (ou de celle de l’URL cible, si définie) entre les dates sélectionnées.
type: integer nullable
position_prev: La meilleure position (ou celle de l’URL cible, si définie) à la date de comparaison.
type: integer nullable
search_type_image: Le type de recherche « Image » indique le pourcentage de recherches d’un mot-clé effectuées en images, mettant en évidence l’intérêt pour le contenu visuel.
type: float nullable
search_type_news: Le type de recherche « News » indique le pourcentage de recherches d’un mot-clé effectuées pour des articles d’actualité.
type: float nullable
search_type_video: Le type de recherche « Vidéo » indique le pourcentage de recherches d’un mot-clé effectuées en vidéo, reflétant l’intérêt pour le contenu vidéo.
type: float nullable
search_type_web: Le type de recherche « Web » indique le pourcentage de recherches d’un mot-clé effectuées pour du contenu web général, indiquant l’intérêt pour un large éventail d’informations.
type: float nullable
serp_features: Les Fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_features_prev: Les Fonctionnalités SERP qui apparaissaient dans les résultats de recherche pour un mot-clé à la date de comparaison.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_updated: Date à laquelle nous avons vérifié pour la dernière fois les résultats du moteur de recherche pour un mot-clé.
type: datetime nullable
serp_updated_prev: Date à laquelle nous avons vérifié les résultats du moteur de recherche jusqu’à la date de comparaison.
type: datetime nullable
tags: Liste des tags attribués à un mot-clé.
type: array(string)
tags_prev: Liste des tags attribués à un mot-clé à la date de comparaison.
type: array(string)
target_positions_count: Nombre d’URL cibles classées pour un mot-clé.
type: integer
traffic: Estimation du nombre de visites mensuelles qu’une page reçoit depuis la recherche organique sur le dernier mois, ou sur les 12 derniers mois de données connues selon le paramètre « volume_mode ».
type: integer nullable
traffic_diff: Variation du trafic entre les dates sélectionnées.
type: integer nullable
traffic_prev: Estimation du nombre de visites mensuelles qu’une page reçoit depuis la recherche organique sur le dernier mois, ou sur les 12 derniers mois de données connues selon le paramètre « volume_mode ».
type: integer nullable
url: L’URL la mieux classée (ou l’URL cible, si définie) en recherche organique.
type: string nullable
url_prev: L’URL la mieux classée (ou l’URL cible, si définie) à la date de comparaison.
type: string nullable
volume: Estimation du Volume de recherche mensuel moyen pour un mot-clé sur le dernier mois, ou sur les 12 derniers mois de données connues selon le paramètre « volume_mode ».
type: integer nullable
volume_desktop_pct: Pourcentage du volume de recherche total provenant d’appareils desktop.
type: float nullable
volume_mobile_pct: Pourcentage du volume de recherche total provenant d’appareils mobiles.
type: float nullable
Une liste de colonnes, séparées par des virgules, à renvoyer. Voir le Schéma de réponse pour les identifiants de colonne valides.
Une date avec laquelle comparer les métriques, au format YYYY-MM-DD.
Une date pour laquelle établir un rapport sur les métriques, au format AAAA-MM-JJ.
Choisissez entre les classements mobile et desktop.
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#
Mode de calcul du volume de recherche : mensuel ou moyen. Cela affecte le volume, le trafic et la valeur de trafic.
Le format de sortie.
Réponses
La meilleure position (ou celle de l’URL cible, si définie) a une vignette.
La meilleure position (ou celle de l’URL cible, si définie) avait une vignette à la date de comparaison.
La meilleure position (ou celle de l’URL cible, si définie) a un aperçu vidéo.
La meilleure position (ou celle de l’URL cible, si définie) avait un aperçu vidéo à la date de comparaison.
Le type de meilleure position (ou celui de l’URL cible, si définie) : organique, payante ou une fonctionnalité SERP.
Le type de meilleure position (ou d’URL cibles, si définies) à la date de comparaison.
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.
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é.
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é.
Le pays dans lequel un mot-clé donné est suivi. Code pays à deux lettres (ISO 3166-1 alpha-2).
Le pays dans lequel un mot-clé donné est suivi à la date de comparaison. Code pays à deux lettres (ISO 3166-1 alpha-2).
La date à laquelle un mot-clé a été ajouté au projet.
Intention de l'utilisateur : de marque. L'utilisateur recherche une marque ou un nom d'entreprise spécifique.
Intention de l'utilisateur : commerciale. L'utilisateur compare des produits ou des services avant de prendre une décision d'achat.
Intention de l'utilisateur : informationnel. L'utilisateur recherche des informations ou une réponse à une question spécifique.
Intention de l'utilisateur : local. L'utilisateur recherche des informations pertinentes relatives à un emplacement spécifique ou à des services à proximité.
Intention de l'utilisateur : navigationnel. L'utilisateur recherche un site web ou une page web spécifique.
Intention de l'utilisateur : transactionnel. L'utilisateur est prêt à effectuer une action, souvent un achat.
Le mot-clé pour lequel votre cible se classe.
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.
Renvoyera false si le mot-clé est toujours en cours de traitement et qu’aucune SERP n’a encore été récupérée.
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.
Le mot-clé pour lequel votre cible se classe à la date de comparaison.
La langue de la SERP pour laquelle un mot-clé donné est suivi.
La langue de la SERP à la date de comparaison.
L’emplacement (pays, état/province ou ville) dans lequel un mot-clé donné est suivi.
L’emplacement (pays, état/province ou ville) dans lequel un mot-clé donné est suivi à la date de comparaison.
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.
La meilleure position (ou les URL cibles, si définies) dans la recherche organique.
La variation de la meilleure position (ou des URL cibles, si définies) entre les dates sélectionnées.
La meilleure position (ou les URL cibles, si définies) à la date de comparaison.
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.
Le type de recherche Actualités indique le pourcentage de recherches pour un mot-clé effectuées pour des articles d'actualité.
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.
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.
Les fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé.
Les fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé à la date de comparaison.
Date de la dernière vérification des résultats des moteurs de recherche pour un mot-clé.
La date à laquelle nous avons vérifié les résultats des moteurs de recherche jusqu’à la date de comparaison.
Une liste de tags attribués à un mot-clé donné.
Une liste de tags attribués à un mot-clé donné à la date de comparaison.
Le nombre d’URL cibles classées pour un mot-clé.
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 ».
Le changement de trafic entre vos dates sélectionnées.
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 ».
L’URL la mieux classée (ou l’URL cible, si elle est définie) en recherche organique.
L’URL la mieux classée (ou l’URL cible, si elle est définie) à la date de comparaison.
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 ».
Le pourcentage du volume de recherche total provenant des appareils de bureau.
Le pourcentage du volume de recherche total provenant des appareils mobiles.