Покази

API + MCP

GET/v3/brand-radar/impressions-history

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

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

wherestring

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

report_idstring

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

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

Бренд для пошуку.

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

date_fromstring (date)Обов’язково

Дата початку історичного періоду у форматі YYYY-MM-DD.

date_tostring (date)

Дата завершення історичного періоду у форматі YYYY-MM-DD.

search_volume_typestring

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

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

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

outputstring

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

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

Відповіді

metricsarray<object>

datestring (date)

impressionsinteger

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