Топ по ключевой фразе V4 (SerpstatKeywordProcedure.getKeywordTop)

SerpstatKeywordProcedure.getKeywordTop — метод возвращает последний топ по ключевой фразе.

Параметры запроса:

Название параметра	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
keyword	Фраза, для которой будет происходить поиск	string	нет		купить машину
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
filters	Условия фильтрации	int	да	{"top_size": 100}	{"top_size": 100} top_size цифровое значение от 1 до 100

Метрики ответа

Метрики	Описание
result	Инкапсулирует в себе ответ
results	Количество результатов
top	Инкапсулирует результат
url	Страница которая находится на позиции (указано в ""position"")
domain	Домен
subdomain	Поддомен домена
position	Позиция по ключевой фразе в поисковой выдаче
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое )
text	Текст рекламного объявления (если есть контекстная реклама)
title	Заголовок рекламного объявления (если есть контекстная реклама)
ads	Инкапсулирует результаты контекстной рекламы (если она есть)
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных ключевых фраз в ответе. За один запрос можно получить не более 60000 результатов.

Часть ответа API, за которую снимается 1 лимит:

{
"position": 1,
"url": "https://chrome.google.com/webstore/detail/google-play-music/icppfcnhkcmnfdhfhphakoifcfokfdhg?hl=ru",
"domain": "google.com",
"subdomain": "chrome.google.com",
"types": [
    "related_search",
    "ads_top",
    "video",
    "snip_breadcrumbs"
]
}

Example PHP Python

Request data:


{
 "id": {{any_num_or_string}},
 "method": "SerpstatKeywordProcedure.getKeywordTop",
 "params": {
   "keyword": {{keyword}},
   "se": {{search_engine}},
   (optional) "filters": {"top_size": {{top_size}}}
 }
}

Response data:


{
    "id": {{your_num_or_string}},
    "result": {
        "data": {
            "top": [
                {
                    "position": 1,
                    "url": "https://www.citrus.ua/televizory/",
                    "domain": "citrus.ua",
                    "subdomain": "www.citrus.ua",
                    "types": [
                        "ads_bot",
                        "pic",
                        "related_search",
                        "video"
                    ]
                },
                {
                    "position": 2,
                    "url": "https://allo.ua/ru/televizory/",
                    "domain": "allo.ua",
                    "subdomain": null,
                    "types": [
                        "ads_bot",
                        "pic",
                        "related_search",
                        "video",
                        "snip_breadcrumbs"
                    ]
                }
            ],
            "ads": {
                "3": [
                    {
                        "position": 1,
                        "url": "https://ru.aliexpress.com/popular/55-inch-tv.html",
                        "domain": "aliexpress.com",
                        "subdomain": "ru.aliexpress.com",
                        "text": "Миллионы товаров по оптовым ценам. Огромные скидки, покупайте сегодня! Safe Payment. Buyer Protection. Free Shipping. Great Value. Шоу: Одежда, Телефоны, Компьютер, Электроника, Ювелирные, Мебель, Сумки, игрушки, часы, обувь.",
                        "title": "Купить Телевизор 55 Дюймов недорого из Китая на AliExpress"
                    }
                ]
            },
            "types": [
                "pic",
                "related_search"
            ],
            "results": 86,
            "right_spell": false
        },
        "summary_info": {
            "left_lines": 99268
        }
    }
}