Огляд SERP

API + MCP

GET/v3/rank-tracker/serp-overview

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.

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

top_positionsinteger

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

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

Виберіть позиції для мобільних або десктопних пристроїв.

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

datestring

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

location_idinteger

Ідентифікатор локації для відстежуваного ключового слова. Ви можете використати endpoint management/project-keywords, щоб отримати коди країн, коди мов та ідентифікатори локацій для ваших відстежуваних ключових слів.

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

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

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

language_codestring

Код мови для відстежуваного ключового слова. Ви можете використати endpoint management/project-keywords, щоб отримати коди країн, коди мов та ідентифікатори локацій для ваших відстежуваних ключових слів.

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

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

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

Унікальний ідентифікатор проєкту. Його можна знайти в URL вашого проєкту Rank Tracker в Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

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

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

Відповіді

positionsarray<object>

ahrefs_rankinteger or null

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

backlinksinteger or null

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

domain_ratingnumber or null

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

keywordsinteger or null

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

nr_wordsinteger or null

Загальна кількість слів, присутніх у HTML-коді веб-сторінки.

page_typestring or null

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

positioninteger

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

refdomainsinteger or null

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

titlestring or null

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

top_keywordstring or null

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

top_keyword_volumeinteger or null

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

trafficinteger or null

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

typearray<string>

Тип позиції: органічна, платна або «Функції SERP». Дозволені значення: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

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

urlstring or null

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

url_ratingnumber or null

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

valueinteger or null

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