Цитовані сторінки

API + MCP

GET/v3/brand-radar/cited-pages

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

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

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

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

Доступні поля:

responses
url

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…

tracked_urlsstring

Список URL-адрес відстежуваних сторінок, розділений комами. Якщо його вказано, відповідь міститиме рядки з нульовою кількістю цитувань для будь-яких відстежуваних URL-адрес, для яких немає даних.

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

Відповіді

pagesarray<object>

mentionsarray<object>

Застаріло з 2026-02-10.

responsesinteger

Кількість відповідей, у яких згадувалася ця сторінка.

urlstring

URL процитованої сторінки.

volumeinteger

Застаріло з 2026-03-24.