Відповіді ШІ

API + MCP

GET/v3/brand-radar/ai-responses

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

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

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

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

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

limitinteger

Кількість результатів, які потрібно повернути.

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

datestring (date)

Дата для пошуку у форматі YYYY-MM-DD.

date_comparedstring (date)

Дата для порівняння з date у форматі YYYY-MM-DD. Має бути строго ранішою за date. Якщо задано, звіт охоплює кожен запит, на який було надано відповідь у будь-яку з цих дат, а поле status показує, як кожен із них змінився між ними. Запит, на який було надано відповідь лише в date_compared, позначається як lost, а решта його полів описують відповідь для date_compared, оскільки для date її немає.

search_volume_typestring

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

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

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

order_bystring

Стовпець, за яким слід упорядкувати результати.

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

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

outputstring

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

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

Відповіді

ai_responsesarray<object>

countrystring

Країна запитання.

data_sourcestring

Модель чатбота, яка згенерувала відповідь.

last_updatedstring (date)

Дата останнього оновлення даних.

linksarray<object>

(10 одиниць) Посилання, використані для відповіді.

urlstring

titlestring or null

questionstring

Запитання, поставлене користувачем.

responsestring

(10 одиниць) Відповідь моделі.

search_queriesarray<string>

Пошуковий запит, який чатбот використовує, щоб знайти інформацію для відповіді. Примітка: якщо data_source не містить chatgpt або perplexity, це поле завжди буде порожнім.

statusstring or null

Як запит змінився між date_compared і date. Null, якщо не задано date_compared. new — відповідь надано в date, але не в date_compared. lost — відповідь надано в date_compared, але не в date; решта полів цього рядка описує відповідь за date_compared, оскільки за date її немає. no_change — відповідь надано в обидві дати, що нічого не каже про те, чи змінилися сама відповідь, згадки або цитування.

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

tagsarray<string>

Теги, призначені запиту.

volumeinteger

(10 одиниць) Орієнтовний місячний обсяг пошуку. Це базується на наших оцінках для Google й поєднує обсяги пошуку пов'язаних ключових слів, у яких це запитання з'являється в розділі People Also Ask.