Docs
Пошук документації...⌘K

Історія огляду — Згадки

API + MCP
POST/v3/brand-radar/mentions-history

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

Кожна сутність, указана в brands (а також у competitors, якщо застосовно), має містити принаймні одне значення в names. Сутності, що складаються лише з url_groups, тут не підтримуються, оскільки згадки зіставляються з назвами брендів.

Тіло запиту

whereobject

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

tags_filterobject

Вираз фільтра для тегів підказки. Потрібен report_id. Використовує синтаксис фільтра з такими обмеженнями: єдина допустима назва поля — "tag"; єдині допустимі оператори: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; максимальна глибина вкладеності and, or — 2. Приклад: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

date_tostring (date)

Кінцева дата історичного періоду у форматі YYYY-MM-DD.

date_fromstring (date)Required

Початкова дата історичного періоду у форматі YYYY-MM-DD.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
report_idstring

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

promptsstring

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

Allowed values:ahrefscustom
data_sourcearray<string>Required

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

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

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

brandsarray<object>

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

Default:
At least one of names or url_groups is required
namesarray<string>

Назви бренду/конкурента.

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Домен цілі.

Example:ahrefs.com
scopestringrequired

Область застосування цілі.

Allowed values:urlpathdomainsubdomains
outputstring

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

Allowed values:jsoncsvxmlphp

Відповіді

metricsarray<object>
datestring (date)
mentionsinteger

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