Історія огляду — Частка голосу

API + MCP

GET/v3/brand-radar/sov-history

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

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

wherestring

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

date_tostring (date)

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

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

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

search_volume_typestring

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

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

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

countrystring

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

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

report_idstring

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

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

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

Відповіді

metricsarray<object>

datestring (date)

share_of_voicearray<object>

(1 одиниця на бренд) Оціночна частка голосу бренду.

brandstring

share_of_voicenumber (float)