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

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. Цей параметр буде визнано застарілим 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

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

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

Відповіді

metricsarray<object>

datestring (date)

share_of_voicearray<object>

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

brandstring

share_of_voicenumber (float)