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

Цитовані домени

API + MCP
POST/v3/brand-radar/cited-domains

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

Тіло запиту

volume_rangeobject

Діапазон обсягу для фільтрації.

frominteger
tointeger
selectarray<string>Required

Список полів для повернення.

Доступні поля:
  • domain
  • pages
  • responses
Example:["field_a","field_b"]
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"]}]}.

limitinteger

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

Default:1000
datestring (date)

Дата для пошуку у форматі 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 — після цієї дати параметр більше не матиме жодного ефекту.

competitorsarray<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
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:jsonphp

Відповіді

domainsarray<object>
domainstring

Назва процитованого домену.

mentionsarray<object>

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

pagesinteger

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

responsesinteger

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

volumeinteger

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