Огляд SERP

API + MCP

GET/v3/serp-overview/serp-overview

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

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

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

top_positionsinteger

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

datestring (date-time)

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

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

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

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

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

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

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.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

update_datestring (date-time)

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

urlstring or null

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

url_ratingnumber (float) or null

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

valueinteger or null

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