Данные по ключевому слову V4 (SerpstatKeywordProcedure.getKeywordsInfo)
SerpstatKeywordProcedure.getKeywordsInfo — метод возвращает данные по ключевому слову.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
keywords | Фраза, для которой будет происходить поиск | string | нет | купить машину | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
{"cost": "desc"} |
Сортировка результатов возможна по следующим поля:
Параметр |
cost |
concurrency |
found_results |
region_queries_count |
region_queries_count_wide |
region_queries_count_phrase |
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
keyword | Заданная ключевая фраза |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
found_results | Количество найденных результатов по ключевой фразе ""keyword"" |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
region_queries_count_phrase
|
|
types
|
Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
social_domains | Социальные домены, которые находятся в топ-10 по заданной фразе |
right_spelling | Рекомендация к исправлению для ключевой фразы с орфографической ошибкой |
keyword_length | Количество слов, разделенных пробелом в ключевой фразе |
lang | Язык |
suggestions_count
|
Количество поисковых подсказок |
keywords_count
|
Количество ключевых фраз |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "купить машину",
"cost": 0.10480200000000001,
"concurrency": 48,
"found_results": 138000000,
"region_queries_count": 33100,
"region_queries_count_wide": 135000,
"region_queries_count_phrase": 0,
"types": [
"pic",
"local_pack",
"related_search",
"video",
"kn_graph_carousel_list"
],
"geo_names": [],
"social_domains": [
"pinterest"
],
"right_spelling": null,
"lang": "ru",
"suggestions_count": 38384,
"keywords_count": 277261
}
{
"id": {{any_num_or_string}},
"method": "SerpstatKeywordProcedure.getKeywordsInfo",
"params": {
"keywords": [{{keyword}}, {{keyword}}, ...],
"se": {{search_engine}},
(optional) "sort": {"top_size": {{top_size}}} // all numeric fields, except suggestions_count and keywords_count
}
}
{
"id": {{your_num_or_string}},
"result": {
"data": [
{
"keyword": "купить машину",
"cost": 0.10480200000000001,
"concurrency": 48,
"found_results": 138000000,
"region_queries_count": 33100,
"region_queries_count_wide": 135000,
"region_queries_count_phrase": 0,
"types": [
"pic",
"local_pack",
"related_search",
"video",
"kn_graph_carousel_list"
],
"geo_names": [],
"social_domains": [
"pinterest"
],
"right_spelling": null,
"lang": "ru",
"suggestions_count": 38384,
"keywords_count": 277261
}
],
"summary_info": {
"left_lines": 996252
}
}
}