Топ по ключевой фразе V4 (SerpstatKeywordProcedure.getKeywordTop)
SerpstatKeywordProcedure.getKeywordTop — метод возвращает последний топ по ключевой фразе.
Параметры запроса:
| Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
|---|---|---|---|---|---|
| keyword | Фраза, для которой будет происходить поиск | string | нет | купить машину | |
| se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
| filters | Условия фильтрации | int | да | {"top_size": 100} |
{"top_size": 100} |
Метрики ответа :
| Метрики | Описание |
| result | Инкапсулирует в себе ответ |
| results | Количество результатов |
| top | Инкапсулирует результат |
| url | Страница которая находится на позиции (указано в ""position"") |
| domain | Домен |
| subdomain | Поддомен домена |
| position | Позиция по ключевой фразе в поисковой выдаче |
| types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
| text | Текст рекламного объявления (если есть контекстная реклама) |
| title | Заголовок рекламного объявления (если есть контекстная реклама) |
| ads | Инкапсулирует результаты контекстной рекламы (если она есть) |
| left_lines | Количество оставшихся API строк |
Список дополнительных элементов для Google:
| Название | Описание |
| a_box_c_converter | Калькулятор конвертации валют |
| a_box_card | Карточка с информацией о турнирах |
| a_box_color_picker | Палитра цветов (палитра цветов) |
| a_box_dictionary | Фрагмент словаря (расшифровка, транскрипция запроса, толкование) |
| a_box_dtime | Показывает местную дату и время |
| a_box_earthquake | Информация о землетрясениях в районе |
| a_box_flights | Таблица с информацией по авиаперелетам |
| a_box_fsnippet | Большой информационный сниппет |
| a_box_g_converter | Общий конвертер величин |
| a_box_map | Карта с маршрутами и адресами |
| a_box_nutrition | Числовые показатели питательности для продуктов |
| a_box_population | График динамики населения |
| a_box_some | Даты, адреса и т.п. |
| a_box_sports | Информация о спортивных событиях (кто? когда? где?) |
| a_box_stock | График с биржевыми котировками |
| a_box_translation | Блок для перевода |
| a_box_weather | Прогноз погоды |
| a_box_when_is | Ответ на запрос о дате события |
| ads_bot | Блок контекстной рекламы внизу поисковой выдачи |
| ads_rhs | Блок контекстной рекламы справа от поисковой выдачи |
| ads_top | Блок контекстной рекламы сверху поисковой выдачи |
| also_asks | Список вопросов связанных с запросом |
| bests | Ссылки на обзоры, лучшие по рейтингу товары/услуги |
| calc | Онлайн калькулятор |
| car_loan_calc | Калькулятор автокредита |
| discover_places | Популярные направления |
| graph | График запроса |
| kn_graph_brand | Информация про искомую организацию |
| kn_graph_card | Информационная карточка |
| kn_graph_carousel_list | Блок с каруселью — один ряд плашек, каждая переход на другую страницу поиска |
| kn_graph_carousel_table | Блок с каруселью - несколько рядов плашек с переходом |
| kn_graph_disambiguation | Другие варианты поиска, справа под графом знаний |
| kn_graph_health | Блок с описанием болезни |
| kn_graph_hotel_booking | Бронирование комнаты в гостинице - часть графа знаний |
| kn_graph_local | Граф знаний с картой |
| local_pack | Блок с картой и 3 адресами |
| map | Карта |
| mortgage_calc | Расчет ипотеки |
| pic | Примеры картинок для запроса |
| refine_by_brand | Список товаров по брендам для запроса |
| related_search | Похожие фразы, подсказки |
| research | Подборка статей по запросу, находится среди сниппетов |
| shopping_rhs | Блок покупок справа |
| shopping_top | Блок покупок сверху топа |
| shopping_bottom | Блок покупок внизу топа |
| snip_breadcrumbs | Хлебные крошки вместо URL |
| snip_doc_type | Формат документа возле title сниппета |
| snip_https | https в URL |
| snip_image_thumbnail | Изображение в сниппете |
| snip_info | Дополнительная информация - контакты, даты, события, учредители, химический состав ... |
| snip_reviews_stars | Рейтинг статьи со звездочками |
| snip_search_box | Поисковая строка внутри сниппета |
| snip_sitelinks | Дополнительные ссылки внутри сниппета на другие разделы сайта |
| snip_twitter | Блок с сообщениями из твиттера |
| snip_video_thumbnail | Иконка для видео внутри сниппета |
| snip_amp_logo | Иконка справа после bradcrumbs |
| snip_best_answer | Текст в рамке в сниппете в виде карусели |
| top_stories | Список новостных статей |
| a_box_knowledge_game | В выдаче под переводчиком есть блок с вопросом и кнопками ответов |
| recipes | Блок с рецептами вверху |
| app_store | Блок в средине выдачи с приложениями в App Store |
| podcasts | Блок с подкастами в середине |
| x_cat_ads | Блок с категоризированными компаниями |
| Список дополнительных элементов для Яндекс: | |
| entity | Справка об объекте |
| adv_banner | Рекламные баннера |
| companies | Компании |
| carousel | Карусель |
| fact | Ответ фактом |
| homonyms | Омонимы |
| travel | Путешествия |
| auto | Авто |
| avia | Авиа |
| translate | Перевод |
| collections | Коллекции |
| map | Карта |
| pic | Картинки |
| video | Видео |
| news | Новости |
| converter | Конвертер |
| calc | Калькулятор |
| market | Маркет |
| afisha | Афиша |
| metro | Метро |
| music | Музыка |
| oplata | Оплата |
| radio | Радио в выдаче |
| rasp | Расписания Яндекса |
| realty | Недвижимость |
| taxi | Такси |
| time | Время |
| tv | ТВ |
| pogoda | Погода |
| math | Математика |
| related | Также ищут |
| ads | Реклама |
| sport | Спорт |
| snippet_rating | Рейтинг |
| snippet_adress | Адреса |
| snippet_info | Дополнительная информация |
| snippet_sitelinks | Ссылки на сайт |
| snippet_table | Таблица |
| snippet_video | Сниппет с видео |
| snippet_list | Список в сниппете |
| snippet_redir | Редирект |
| snippet_social | Социальный сниппет |
Лимиты: количество списанных лимитов соответс
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
}
}
}