Docs
Rechercher dans la documentation...⌘K

Réponses basées sur l’IA

API + MCP
POST/v3/brand-radar/ai-responses

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.

Corps de la requête

volume_rangeobject

La plage de volume à utiliser comme filtre.

frominteger
tointeger
selectarray<string>Required

Une liste de champs à renvoyer.

Example:["field_a","field_b"]
whereobject

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

tags_filterobject

Une expression de filtre pour les tags de prompt. Nécessite report_id. Utilise la syntaxe de filtre avec les restrictions suivantes : le seul nom de champ valide est "tag" ; les seuls opérateurs valides sont : "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty" ; la profondeur d'imbrication maximale de and, or est 2. Exemple : {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

limitinteger

Nombre de résultats à renvoyer.

Default:1000
datestring (date)

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

countryarray<string>

Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
order_bystring

Une colonne selon laquelle trier les résultats.

Allowed values:relevancevolume
Default:relevance
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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

Une liste de modèles de chatbot. 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.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

Une liste 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.

competitorsarray<object>

Une liste de noms et de sites web de concurrents à rechercher.

Default:
At least one of names or url_groups is required
namesarray<string>

Les noms de la marque/du concurrent

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Le domaine de la cible

Example:ahrefs.com
scopestringrequired

Portée de la cible.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

Une liste de noms et de sites web de marques à rechercher.

Default:
At least one of names or url_groups is required
namesarray<string>

Les noms de la marque/du concurrent

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Le domaine de la cible

Example:ahrefs.com
scopestringrequired

Portée de la cible.

Allowed values:urlpathdomainsubdomains
outputstring

Le format de sortie.

Allowed values:jsonphp

Réponses

ai_responsesarray<object>
countrystring

Le pays de la question.

data_sourcestring

Le modèle de chatbot qui a généré la réponse.

last_updatedstring (date)

La date à laquelle les données ont été mises à jour pour la dernière fois.

linksarray<object>

(10 unités) Les liens utilisés pour la réponse.

urlstring
titlestring or null
questionstring

La question posée par l’utilisateur.

responsestring

(10 unités) La réponse du modèle.

search_queriesarray<string>

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.

tagsarray<string>

Étiquettes attribuées à la requête.

volumeinteger

(10 unités) Volume de recherche mensuel estimé. Cette estimation est basée sur nos données pour Google, en combinant les volumes de recherche de mots-clés associés lorsque cette question apparaît dans la section « Autres questions posées ».