Відповіді ШІ

API + MCP

GET/v3/brand-radar/ai-responses

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

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

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

Список полів для повернення, розділений комами. Доступні поля: question, response, volume, country, links, search_queries, tags, data_source, last_updated.

wherestring

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

cited_domain: Домен сторінки, яка використовувалася для створення відповіді.
тип: домен

cited_domain_subdomains: Домен сторінки, яка використовувалася для створення відповіді. Також збігатиметься будь-який субдомен указаного домену.
тип: рядок

cited_url_exact: URL сторінки, яка використовувалася для створення відповіді.
тип: рядок

cited_url_prefix: URL сторінки, яка використовувалася для створення відповіді. Збігатиметься будь-який URL, що починається з цього префікса.
тип: рядок

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

response (10 одиниць): Відповідь від моделі.
тип: рядок

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

topic: Тема запиту.
тип: рядок

limitinteger

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

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

datestring (date)

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

countrystring

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

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

order_bystring

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

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

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

report_idstring

ID звіту, який потрібно використати. Якщо його задано, інші параметри беруться зі звіту (бренд, конкуренти, ринок, країна, фільтри). Якщо задано країну або фільтри, вони замінюють значення зі звіту. Його можна знайти в URL вашого звіту Brand Radar в Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Тип запитів, які потрібно використовувати. Якщо не вказано, буде використано обидва типи. Користувацькі запити потребують вказаного report_id.

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

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

Список моделей чатботів, розділених комами. Моделі ключових слів Google (google_ai_overviews_keywords, google_ai_mode_keywords) не можна поєднувати між собою або з іншими моделями.

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

Example:chatgpt,perplexity

marketstring

Список нішевих ринків ваших брендів, розділений комами. Застаріє 18.05.2026 — після цієї дати параметр більше не матиме жодного ефекту.

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.