Domaines cités

API + MCP

GET/v3/brand-radar/cited-domains

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 :

domain
pages
responses

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.

countrystring

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

Valeurs autorisées:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

L’ID du rapport à utiliser. Si un ID est fourni, les autres paramètres sont repris depuis le rapport (marque, concurrents, marché, pays, filtres). Si des paramètres de pays ou de 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. Si non spécifié, les deux types 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. Les modèles de mots-clés Google (google_ai_overviews_keywords, google_ai_mode_keywords) ne peuvent pas être combinés entre eux ni avec d’autres modèles.

Valeurs autorisées:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

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

competitorsstring

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

brandstring

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

outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Réponses

domainsarray<object>

domainstring

Le nom de domaine cité.

mentionsarray<object>

Obsolète depuis le 2026-02-10.

pagesinteger

Le nombre de pages uniques du domaine qui ont été citées dans les réponses.

responsesinteger

Le nombre de réponses qui ont cité le domaine.

volumeinteger

Obsolète depuis le 2026-03-24.