Огляд SERP

API + MCP

GET/v3/serp-overview/serp-overview

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

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

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

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

Ключове слово, для якого потрібно повернути огляд SERP.

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

Двобуквений код країни (ISO 3166-1 alpha-2).

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

datestring (date-time)

Часова мітка, за якою повертається останній доступний огляд SERP, у форматі YYYY-MM-DDThh:mm:ss. Якщо її не вказано, повертається найсвіжіший огляд SERP.

top_positionsinteger

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

typestring

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

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

outputstring

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

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

Відповіді

positionsarray<object>

ahrefs_rankinteger or null

Сила профілю беклінків домену порівняно з іншими вебсайтами в нашій базі даних, причому рейтинг №1 є найсильнішим.

backlinksinteger or null

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

domain_ratingnumber (float) or null

Сила профілю беклінків домену порівняно з іншими в нашій базі даних за 100-бальною шкалою.

keywordsinteger or null

Загальна кількість ключових слів, за якою результат пошуку ранжується в топ-100 органічних позицій.

page_typestring or null

Список шляхів ієрархічних типів сторінок, передбачених ШІ для сторінки, що ранжується, розділений комами. Кожне значення — шлях із префіксом «/» (наприклад, /Article/How_to).

positioninteger

Позиція результату пошуку в SERP.

refdomainsinteger or null

(5 одиниць) Загальна кількість унікальних доменів, що містять посилання на результат пошуку.

titlestring or null

Заголовок сторінки, що ранжується.

top_keywordstring or null

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

top_keyword_volumeinteger or null

(10 одиниць) Оцінка середньої щомісячної кількості запитів за основним ключовим словом за останні відомі 12 місяців даних.

trafficinteger or null

(10 одиниць) Оцінка місячного органічного пошукового трафіку, який результат отримує з усіх ключових слів, за якими він ранжується.

typearray<string>

Тип позиції: органічна, платна або функція SERP.

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

update_datestring (date-time)

Дата, коли ми перевірили результати з пошукової системи за ключовим словом.

urlstring or null

URL сторінки, що ранжується.

url_ratingnumber (float) or null

Сила профілю беклінків сторінки за 100-бальною логарифмічною шкалою.

valueinteger or null

(10 одиниць) Приблизна вартість щомісячного органічного пошукового трафіку сторінки в центах USD.