Pages citées

API + MCP

GET/v3/brand-radar/cited-pages

Les requêtes vers ce point de terminaison consomment des unités d’API en fonction du paramètre prompts : les requêtes ne renvoyant que des données de prompt personnalisé sont gratuites, tandis que les requêtes incluant des données de prompt Ahrefs sont facturées selon la tarification Standard des unités d’API.

Paramètres de requête

selectstringObligatoire

Une liste de champs à renvoyer, séparés par des virgules.

Champs disponibles :

responses
url

wherestring

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

limitinteger

Nombre de résultats à renvoyer.

Par défaut:1000

datestring (date)

La date à rechercher, au format AAAA-MM-JJ.

search_volume_typestring

Les rapports de visibilité IA passent au volume IA ajusté. Il estime mieux la demande de réponses IA sur l’ensemble des chatbots et des surfaces de recherche IA. Il est calculé en ajustant le volume de recherche Google en fonction de l’utilisation estimée de chaque plateforme IA par rapport à Google. Ce paramètre sera déprécié le 30 septembre 2026 ; toutes les requêtes utiliseront le nouveau volume IA ajusté.

Valeurs autorisées:ask_volumekeyword_volume

Par défaut:ask_volume

countrystring

Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2), séparés par des virgules.

Valeurs autorisées:adaeafagaialamaoarasatauawazba…

tracked_urlsstring

Liste des URL de pages suivies, séparées par des virgules. Lorsqu’elle est fournie, la réponse inclut des lignes avec zéro citation pour toutes les URL suivies qui ne disposent d’aucune donnée.

report_idstring

L’ID du rapport à utiliser. S’il est fourni, les autres paramètres sont repris depuis le rapport (marque, concurrents, marché, pays, filtres). Si le pays ou les filtres sont fournis, ils remplacent ceux du rapport. Vous pouvez le trouver dans l’URL de votre rapport Brand Radar dans Ahrefs : https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Le type de prompts à utiliser. S’il n’est pas spécifié, les deux seront utilisés. Les prompts personnalisés nécessitent qu’un report_id soit fourni.

Valeurs autorisées:ahrefscustom

data_sourcestringObligatoire

Une liste de modèles de chatbot, séparés par des virgules. Tous les modèles peuvent être combinés entre eux. Le module claude ne prend en charge que les prompts personnalisés.
Les modèles google_ai_overviews_keywords et google_ai_mode_keywords indiquent la visibilité AI Overview / Mode IA, dérivée des requêtes de recherche Google (mots-clés) plutôt que des prompts.

Valeurs autorisées:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Une liste de marchés de niche de vos marques, séparés par des virgules. Déprécié le 2026-05-18, ce paramètre n’aura plus d’effet peu après cette date.

competitorsstring

Une liste de concurrents de vos marques, séparés par des virgules.

brandstring

Une liste de marques à rechercher, séparées par des virgules. Au moins un des paramètres brand, competitors, market ou where ne doit pas être vide.

outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Réponses

pagesarray<object>

mentionsarray<object>

Obsolète depuis le 2026-02-10.

responsesinteger

Le nombre de réponses qui ont cité la page.

urlstring

L’URL de la page citée.

volumeinteger

Obsolète depuis le 2026-03-24.