Топ по ключевой фразе 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 | Социальный сниппет |
Лимиты: количество списанных лимитов соответс
{
"id": {{any_num_or_string}},
"method": "SerpstatKeywordProcedure.getKeywordTop",
"params": {
"keyword": {{keyword}},
"se": {{search_engine}},
(optional) "filters": {"top_size": {{top_size}}}
}
}
{
"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
}
}
}