Відповіді ШІ
API + MCPЗапити до цього ендпойнта споживають одиниці API залежно від параметра
prompts: запити, що повертають лише дані користувацького запиту, безплатні, а запити, що включають дані запитів Ahrefs, оплачуються за тарифом Standard на одиниці API.
Параметри запиту
Список полів, які потрібно повернути, розділений комами.
Вираз фільтра. Розпізнаються такі ідентифікатори стовпців (вони відрізняються від ідентифікаторів, які розпізнає параметр select).
ID звіту, який потрібно використати. Якщо його вказано, інші параметри беруться зі звіту (бренд, конкуренти, ринок, країна, фільтри). Якщо вказано країну або фільтри, вони замінюють ті, що у звіті. Його можна знайти в URL вашого звіту Brand Radar в Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
Список брендів для пошуку, розділений комами. Принаймні один із параметрів brand, competitors, market або where не повинен бути порожнім.
Список конкурентів ваших брендів, розділений комами.
Розділений комами список моделей чатботів. Усі моделі можна комбінувати одна з одною. Модуль claude підтримує лише користувацькі запити.
Моделі google_ai_overviews_keywords і google_ai_mode_keywords повідомляють про видимість Оглядів від ШІ / режиму ШІ, отриману з пошукових запитів Google (ключових слів), а не із запитів.
Список дволітерних кодів країн, розділений комами (ISO 3166-1 alpha-2).
Тип запитів, які слід використовувати. Якщо не вказано, використовуватимуться обидва. Для користувацьких запитів потрібно вказати report_id.
Кількість результатів, які потрібно повернути.
Дата для пошуку у форматі YYYY-MM-DD.
Дата для порівняння з date у форматі YYYY-MM-DD. Має бути строго ранішою за date. Якщо задано, звіт охоплює кожен запит, на який було надано відповідь у будь-яку з цих дат, а поле status показує, як кожен із них змінився між ними. Запит, на який було надано відповідь лише в date_compared, позначається як lost, а решта його полів описують відповідь для date_compared, оскільки для date її немає.
Стовпець, за яким потрібно впорядкувати результати.
Формат виводу.
Відповіді
Кожна згадка відстежуваного бренду у відповіді: спочатку ваші бренди, а потім конкуренти в їхньому порядку, разом із тим, як про них говориться у відповіді.
Згаданий відстежуваний бренд.
Яка тональність висловлювання про бренд у цій згадці. Null, якщо дані недоступні.
Про що ця згадка — наприклад, про ціну або якість. Null, якщо дані недоступні.
Речення навколо згадки. Null, якщо його неможливо знайти у відповіді.
Країна запитання.
Модель чатбота, яка згенерувала відповідь.
Етап воронки запиту. Null — якщо етап воронки недоступний.
Мітки наміру запиту, включно з його основним наміром, підтипами та брендовими/локальними атрибутами. Порожній масив означає, що мітки наміру недоступні.
Дата останнього оновлення даних.
(10 одиниць) Посилання, використані для відповіді.
Запитання, поставлене користувачем.
(10 одиниць) Відповідь моделі.
Пошуковий запит, який чатбот використовує, щоб знайти інформацію для відповіді. Примітка: якщо data_source не містить chatgpt або perplexity, це поле завжди буде порожнім.
Як запит змінився між date_compared і date. Null, якщо не задано date_compared. new — відповідь надано в date, але не в date_compared. lost — відповідь надано в date_compared, але не в date; решта полів цього рядка описує відповідь за date_compared, оскільки за date її немає. no_change — відповідь надано в обидві дати, що нічого не каже про те, чи змінилися сама відповідь, згадки або цитування.
Теги, призначені запиту.
(10 одиниць) Орієнтовний місячний обсяг пошуку. Це базується на наших оцінках для Google й поєднує обсяги пошуку пов'язаних ключових слів, у яких це запитання з'являється в розділі People Also Ask.