Огляд — Частка голосу

API + MCP

GET/v3/brand-radar/sov-overview

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

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

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

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

share_of_voicenumber (float)

Орієнтовна частка голосу для вашого бренду.