Звіти Brand Radar

Лише API

POST/v3/management/brand-radar-reports

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.

Параметри запиту

outputstring

Формат виводу.

Дозволені значення:jsonphp

Тіло запиту

prompts_frequencyarray<object>

Частота використання запитів.

data_sourcestringrequired

Джерело даних, яке слід використовувати.

Allowed values:chatgptcopilotgeminigoogle_ai_modegoogle_ai_overviewsgrokperplexity

frequencystringrequired

Інтервал оновлення, який слід використовувати.

Allowed values:dailyweeklymonthlyoff

project_idinteger

ID проєкту для використання.

namestring

Назва звіту.

marketarray<string>

Список нішевих ринків ваших брендів. Застаріє 18.05.2026 — після цієї дати параметр більше не матиме жодного ефекту.

competitors

Щонайменше одне з полів brand, competitors або market має бути непорожнім.

Рекомендовано. Можна вказати назви брендів і групи URL-адрес для точного таргетингу.

At least one of names or url_groups is required

namesarray<string>

Назви бренду/конкурента.

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

Домен цілі.

Example:ahrefs.com

scopestringrequired

Область застосування цілі.

Allowed values:urlpathdomainsubdomains

brand

Щонайменше одне з полів brand, competitors або market має бути непорожнім.

Рекомендовано. Можна вказати назви брендів і групи URL-адрес для точного таргетингу.

At least one of names or url_groups is required

namesarray<string>

Назви бренду/конкурента.

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

Домен цілі.

Example:ahrefs.com

scopestringrequired

Область застосування цілі.

Allowed values:urlpathdomainsubdomains

Відповіді

reportsarray<object>

created_atstring (date)

Дата створення звіту.

project_idinteger or null

ID проєкту, до якого прив'язаний звіт.

prompts_frequencyarray<object>

Запис із полями data_source (можливі значення: chatgpt, copilot, gemini, google_ai_mode, google_ai_overviews, grok, perplexity) і frequency (можливі значення: daily, weekly, monthly, off).

data_sourcestring

frequencystring

report_idstring

Унікальний ідентифікатор звіту.

report_namestring

Назва звіту.

curl "https://api.ahrefs.com/v3/management/brand-radar-reports" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "prompts_frequency": [ { "data_source": "chatgpt", "frequency": "daily" } ], "project_id": 0, "name": "string", "market": ["string"], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": null, "scope": null } ] } ], "brand": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": null, "scope": null } ] } ] }'

{ "reports": [ { "created_at": "string", "project_id": 0, "prompts_frequency": [ { "data_source": "string", "frequency": "string" } ], "report_id": "string", "report_name": "string" } ] }