Відповіді ШІ

API + MCP

GET/v3/brand-radar/ai-responses

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

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

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

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

wherestring

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

limitinteger

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

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

datestring (date)

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

search_volume_typestring

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

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

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

countrystring

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

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

order_bystring

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

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

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

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

Відповіді

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, це поле завжди буде порожнім.

tagsarray<string>

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

volumeinteger

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