Данные по ключевому слову V4 (SerpstatKeywordProcedure.getKeywordsInfo)
Метод SerpstatKeywordProcedure.getKeywordsInfo возвращает данные по ключевому слову (частотность ключевой фразы в выбранном регионе, цена за клик, конкуренция ключевой фразы в PPC и т.п.). Аналогичен отчету «Суммарный отчет» в Анализе ключевых фраз, за вычетом графиков и диаграмм.
Общие параметры запроса и инструкция по использованию Serpstat API
Перечень доступных баз и стран
| Параметры запроса | ||||||
|---|---|---|---|---|---|---|
| Параметр | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений | |
| se | Идентификатор поисковой базы, по которой будет проходить поиск (доступны базы Google и Yandex на выбор, пример: g_us, y_157). | string | нет | g_us | ||
| method | Название метода API | string | нет | SerpstatKeywordProcedure.getKeywordsInfo | ||
| params | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] | array | нет | |||
| keywords | Массив фраз, для которых будет происходить поиск | array | нет | ["iphone", "iphone 11"] | ||
| se |
|
string | нет | g_us | ||
| sort |
Порядок сортировки результатов в формате: |
array | да | [ ] пустой массив |
{"cost": "desc"} |
|
| filters |
Условия фильтрации |
array | да | true; false |
{"right_spelling": true} |
|
| Параметры ответа | |
| Параметр | Описание |
| id | Идентификатор запроса: соответствует id в запросе |
| result | Содержит в себе ответ |
| data | Массив с данными ответа |
| keyword | Заданная ключевая фраза |
| cost | Цена за клик, $ |
| concurrency | Конкуренция ключевой фразы в PPC (0-100%) |
| found_results | Количество найденных результатов по ключевой фразе |
| region_queries_count | Частотность ключевой фразы в выбранном регионе |
| region_queries_count_wide | Частотность ключевой фразы в широком соответствии |
|
types
|
Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое) |
| geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
| social_domains | Социальные домены, которые находятся в топ-10 по заданной фразе |
| right_spelling | Рекомендация к исправлению для ключевой фразы с орфографической ошибкой |
| lang | Язык |
| difficulty | Уровень конкуренции по фразе для продвижения в топ-10 в органике |
|
suggestions_count
|
Количество поисковых подсказок |
|
keywords_count
|
Количество ключевых фраз |
| summary_info | Объект с данными ответа |
| page | Номер страницы |
| left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "iphone",
"cost": 1.8822413793103445,
"concurrency": 100,
"found_results": 79,
"region_queries_count": 1220000,
"region_queries_count_wide": 0,
"region_queries_count_phrase": 0,
"types": [
"shopping_top",
"kn_graph_carousel_list",
"also_asks"
],
"geo_names": [],
"social_domains": [
"wikipedia",
"amazon",
"reddit"
],
"right_spelling": null,
"lang": null,
"difficulty": 89.5890633703002,
"suggestions_count": 2652668,
"keywords_count": 8323766
},{
"id": "1",
"method": "SerpstatKeywordProcedure.getKeywordsInfo",
"params": {
"keywords": ["iphone", "iphone 11"],
"se": "g_us"
}
}{
"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
}
}
}