Огляд — Покази

API + MCP

GET/v3/brand-radar/impressions-overview

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

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

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: Тема запиту.
тип: рядок

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

Список стовпців, розділених комами, які потрібно повернути. Див. Schema відповіді для коректних ідентифікаторів стовпців.

countrystring

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

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

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, google_ai_mode) не можна поєднувати між собою або з моделями не від Google.

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

Example:chatgpt,perplexity

marketstring

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

competitorsstring

Список конкурентів ваших брендів, розділений комами.

brandstring

Список брендів для пошуку, розділений комами. Принаймні одне з полів brand, competitors, market або where не повинно бути порожнім.

outputstring

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

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

Відповіді

metricsarray<object>

brandstring

Назва бренду (ваш бренд або конкурент, зазначений у запиті).

no_tracked_brandsinteger

Орієнтовна кількість показів із відповідей, пов’язаних із зазначеним ринком, у яких не згадується жоден із наданих брендів (значення дорівнює нулю, якщо market не вказано).

only_competitors_brandsinteger

Орієнтовна кількість показів із відповідей, у яких згадуються лише бренди конкурентів.

only_target_brandinteger

Орієнтовна кількість показів із відповідей, у яких згадується лише ваш бренд.

target_and_competitors_brandsinteger

Орієнтовна кількість показів із відповідей, у яких згадуються і ваш бренд, і бренди конкурентів.

totalinteger

Загальна орієнтовна кількість показів для вашого бренду (включає only_target_brand і target_and_competitors_brands).