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

Вебсторінки

API + MCPЛише для Enterprise
POST/v3/brand-radar/web-pages

Повертає вебсторінки, на яких згадано запитані бренди або запитаних конкурентів. Згадки брендів зіставляються із заголовками сторінок і вмістом із вебіндексу Ahrefs.

Тіло запиту

selectarray<string>Required

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

Example:["field_a","field_b"]
whereobject

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

report_idstring

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

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

Область дії цілі.

Дозволені значення:urlpathdomainsubdomains
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

Область дії цілі.

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

Необов’язкові фрази, які використовуються для включення або виключення результатів залежно від їхнього вмісту.

includearray<string>

Показувати лише результати, що містять принаймні одну з цих точних фраз.

excludearray<string>

Приховувати результати, що містять будь-яку з цих точних фраз.

limitinteger

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

Default:1000
order_bystring

Як упорядкувати вебсторінки.

Дозволені значення:relevancetraffic
Default:relevance
page_typestring

Чи повертати всі вебсторінки, чи лише новинні сторінки.

Дозволені значення:all_pagesnews
Default:all_pages
publication_typestring

Чи повертати всі сторінки, сторінки з одноразовою публікацією або сторінки з повторною публікацією.

Дозволені значення:allpublished_oncerepublished
Default:all
date_fromstring (date)

Початок діапазону дат публікації у форматі YYYY-MM-DD. Потребує date_to.

date_tostring (date)

Кінцева (включно) дата діапазону дат публікації у форматі YYYY-MM-DD. Потребує date_from.

platformstring

Платформа або технологія, яку використовує сторінка.

Дозволені значення:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

Мова сторінки.

Дозволені значення:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

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

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

Відповіді

pagesarray<object>
contentstring

Фрагмент вмісту сторінки, що містить згадку.

domain_ratinginteger

Рейтинг домену для домену сторінки.

referring_domainsinteger or null

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

titlestring

Заголовок сторінки.

trafficnumber (float) or null

Приблизний щомісячний органічний трафік сторінки з пошукових систем.

traffic_valuenumber (float)

Приблизна щомісячна вартість органічного пошукового трафіку сторінки в USD.

urlstring (url)

URL сторінки, на якій згадується запитаний бренд або конкурент.