Топ по ключевой фразе (keyword_top)

С 01.03.2022 методы 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
}