Огляд — Покази

API + MCP

GET/v3/brand-radar/impressions-overview

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

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

wherestring

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

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

Список полів для повернення, розділений комами.

search_volume_typestring

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

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

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

countrystring

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

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

report_idstring

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

promptsstring

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

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

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

marketstring

Список нішевих ринків ваших брендів, розділених комами. З 2026-05-18 цей параметр вважається застарілим; невдовзі після цієї дати він не матиме жодного ефекту.

competitorsstring

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

brandstring

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

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).