Покази

API + MCP

GET/v3/brand-radar/impressions-overview

Запити до цього ендпойнта споживають одиниці API залежно від параметра prompts: запити, що повертають лише дані користувацького запиту, безплатні, а запити, що включають дані запитів Ahrefs, оплачуються за тарифом Standard на одиниці API.

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

selectstringОбов’язково

Розділений комами список полів, які потрібно повернути.

wherestring

Фільтрувальний вираз. Розпізнаються наведені нижче ідентифікатори стовпців (вони відрізняються від ідентифікаторів, які розпізнає параметр select).

report_idstring

ID звіту, який потрібно використати. Якщо його вказано, інші параметри беруться зі звіту (бренд, конкуренти, ринок, країна, фільтри). Якщо вказано країну або фільтри, вони замінюють ті, що у звіті. Його можна знайти в URL вашого звіту Brand Radar в Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstring

Список брендів для пошуку, розділений комами. Принаймні один із параметрів brand, competitors, market або where не повинен бути порожнім.

competitorsstring

Список конкурентів ваших брендів, розділений комами.

data_sourcestringОбов’язково

Розділений комами список моделей чатботів. Усі моделі можна комбінувати одна з одною. Модуль claude підтримує лише користувацькі запити.
Моделі google_ai_overviews_keywords і google_ai_mode_keywords повідомляють про видимість Оглядів від ШІ / режиму ШІ, отриману з пошукових запитів Google (ключових слів), а не із запитів.

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

Example:chatgpt,perplexity

countrystring

Список дволітерних кодів країн, розділений комами (ISO 3166-1 alpha-2).

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

promptsstring

Тип запитів, які слід використовувати. Якщо не вказано, використовуватимуться обидва. Для користувацьких запитів потрібно вказати report_id.

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

search_volume_typestring

Звіти про видимість ШІ переходять на обсяг із поправкою на ШІ. Він точніше оцінює попит на відповіді ШІ в чатботах і пошукових інтерфейсах із ШІ. Його обчислюють, коригуючи обсяг пошуку Google для кожної платформи ШІ на основі оціненого використання порівняно з Google. Цей параметр буде виведено з ужитку 30 вересня 2026 року; усі запити використовуватимуть новий обсяг із поправкою на ШІ.

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

За Замовчуванням:ask_volume

outputstring

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

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

Відповіді

metricsarray<object>

brandstring

Назва бренду (ваш бренд або конкурент, зазначений у запиті).

no_tracked_brandsinteger

Орієнтовна кількість показів із відповідей, пов’язаних із зазначеним ринком, у яких не згадується жоден із наданих брендів (значення дорівнює нулю, якщо market не вказано).

only_competitors_brandsinteger

Орієнтовна кількість показів із відповідей, у яких згадуються лише бренди конкурентів.

only_target_brandinteger

Орієнтовна кількість показів із відповідей, у яких згадується лише ваш бренд.

target_and_competitors_brandsinteger

Орієнтовна кількість показів із відповідей, у яких згадуються і ваш бренд, і бренди конкурентів.

totalinteger

Загальна орієнтовна кількість показів для вашого бренду (включає only_target_brand і target_and_competitors_brands).