Данные по ключевому слову V4 (SerpstatKeywordProcedure.getKeywordsInfo)

SerpstatKeywordProcedure.getKeywordsInfo — метод возвращает данные по ключевому слову.

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

Название параметра	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
keywords	Фраза, для которой будет происходить поиск	string	нет		купить машину
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	[ ] пустой массив	{"cost": "desc"}

Название параметра

Описание

Тип данных

Опциональный

Значение по умолчанию

Варианты значений

keywords

Фраза, для которой будет происходить поиск

string

нет

купить машину

Идентификатор поисковой базы, по которой будет проходить поиск

string

нет

g_ua, g_ru, ...

sort

Порядок сортировки результатов в формате:

{{{field}}: {{order}}}

field - поле, по которому нужно выполнить сортировку

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
}

Example

Request data:


{
 "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
 }
}

Response data:

{
    "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
        }
    }
}