Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

Toп для ключової фрази (keyword_top)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод keyword_top повертає останній топ-100 Google або топ-50 Яндекс по ключовій фразі. Аналогічний до звіту Топ по фразі в Аналізі ключових слів.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
top Містить результат
position Позиція домену за ключовою фразою в пошуковій видачі
url Сторінка, яка знаходиться на вказаній позиції
domain Домен, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за заданною фразою
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
ads Містить результати контекстної реклами (якщо вона є)
results Кількість результатів
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "position": 1,
    "url": "https://www.apple.com/iphone/",
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks",
        "snip_breadcrumbs"
        ]
},

Example
Request data:

api.serpstat.com/v3/keyword_top?query=iphone&token=XXX&se=g_us

Response data:
{
    "result": {
        "top": [
            {
                "position": 1,
                "url": "https://www.apple.com/iphone/",
                "domain": "apple.com",
                "subdomain": "www.apple.com",
                "types": [
                    "shopping_top",
                    "kn_graph_carousel_list",
                    "also_asks",
                    "snip_breadcrumbs"
                ]
            },
            {
                "position": 2,
                "url": "https://www.apple.com/",
                "domain": "apple.com",
                "subdomain": "www.apple.com",
                "types": [
                    "shopping_top",
                    "kn_graph_carousel_list",
                    "also_asks",
                    "snip_breadcrumbs"
                ]
            }
        ],
        "ads": [],
        "types": [
            "shopping_top",
            "kn_graph_carousel_list",
            "also_asks"
        ],
        "results": 79
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999258
}