Historique de l’aperçu - Mentions

API + MCP

GET/v3/brand-radar/mentions-history

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

wherestring

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

cited_domain : Le domaine d’une page utilisée pour générer la réponse.
type : domain

cited_domain_subdomains : Le domaine d’une page utilisée pour générer la réponse. Tout sous-domaine du domaine indiqué correspondra également.
type : string

cited_url_exact : L’URL d’une page utilisée pour générer la réponse.
type : string

cited_url_prefix : Le préfixe d’URL d’une page utilisée pour générer la réponse. Toute URL commençant par ce préfixe correspondra.
type : string

question : La question posée par l’utilisateur.
type : string

response (10 unités) : La réponse du modèle.
type : string

search_queries : La requête de recherche utilisée par le chatbot pour trouver des informations pour la réponse. Remarque : si data_source n’inclut pas chatgpt ou perplexity, ce champ sera toujours vide.
type : string

topic : Le sujet de la requête.
type : string

date_tostring (date)

Date de fin de la période historique, au format AAAA-MM-JJ.

date_fromstring (date)Obligatoire

Date de début de la période historique, 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. S’il est renseigné, les autres paramètres sont récupérés depuis le rapport (market, country, filters). Si country ou filters 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.

brandstringObligatoire

La marque à rechercher.

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

metricsarray<object>

datestring (date)

mentionsinteger

Mentions estimées issues de réponses mentionnant la marque.