Docs
Rechercher dans la documentation...⌘K

Rapports de Brand Radar

API uniquement
POST/v3/management/brand-radar-reports

Les requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.

Paramètres de requête

outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Corps de la requête

prompts_frequencyarray<object>

La fréquence des prompts à utiliser.

data_sourcestringrequired

La source de données à utiliser.

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity
frequencystringrequired

L’intervalle de mise à jour à utiliser.

Allowed values:dailyweeklymonthlyoff
project_idinteger

L’ID du projet à utiliser.

namestring

Le nom du rapport.

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.

competitors

Au moins l’un des champs brand, competitors ou market doit être non vide.

Recommandé. Vous pouvez préciser des noms de marque et des groupes d’URL pour un ciblage précis.

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
brand

Au moins l’un des champs brand, competitors ou market doit être non vide.

Recommandé. Vous pouvez préciser des noms de marque et des groupes d’URL pour un ciblage précis.

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

Réponses

reportsarray<object>
created_atstring (date)

La date de création du rapport.

project_idinteger or null

L’ID du projet auquel le rapport est associé.

prompts_frequencyarray<object>

Un enregistrement avec les champs data_source (valeurs possibles : chatgpt, copilot, gemini, google_ai_mode, google_ai_overviews, grok, perplexity) et frequency (valeurs possibles : daily, weekly, monthly, off).

data_sourcestring
frequencystring
report_idstring

L’identifiant unique du rapport.

report_namestring

Le nom du rapport.