Ключевые слова для фразы V4 (SerpstatKeywordProcedure.getKeywords)

SerpstatKeywordProcedure.getKeywords - метод выполняет полнотекстовый поиск по ключевой фразе и предоставляет данные по найденным ключевым фразам (частотность, стоимость за клик, уровень конкуренции).

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

Название параметра	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
keyword	Фраза, для которой будет происходить поиск	string	нет		купить машину
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
minusKeywords	Список минус-слов при поиске	array	да	[ ] пустой массив
filters	Условия фильтрации	array	да		{"cost_from": 0.1}
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	['cost' => 'asc', 'region_queries_count' => 'desc']	{"keyword": "desc"} или ['cost' => 'asc', 'region_queries_count' => 'desc']
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	"size": {{page_size}} min: 1, max: 1000

Сортировка результатов возможна по следующим поля:

Параметр

cost

concurrency

found_results

region_queries_count

region_queries_count_wide

keyword_length

Для фильтрации результатов используйте следующие параметры:

Параметр	Описание	Возможные значения
queries_from	Минимальная частотность в месяц	0-100000000
queries_to	Максимальная частотность в месяц	0-100000000
cost_from	Минимальная стоимость за клик	0-200
cost_to	Максимальная стоимость за клик	0-200
concurrency_from	Минимальное значение конкуренции ключевой фразы в PPC	0-100
concurrency_to	Максимальное значение конкуренции ключевой фразы в PPC	0-100
minus_keywords	Фильтрация по минус-словам (список слов через запятую)	string

Метрики ответа:

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топ-100 для Google и топ-50 для Яндекс.
keyword	Заданная ключевая фраза
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
found_results	Количество найденных результатов по ключевой фразе ""keyword""
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
social_domains	Социальные домены, которые находятся в топ-10 по заданной фразе
right_spelling	Рекомендация к исправлению для ключевой фразы с орфографической ошибкой
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
lang	Язык
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных ключевых фраз в ответе. За один запрос можно получить не более 60000 результатов.

Часть ответа API, за которую снимается 1 лимит:

{
"keyword": "chrome google play music",
"cost": 0,
"concurrency": 14,
"found_results": 312000000,
"region_queries_count": 10,
"region_queries_count_wide": 0,
"types": [
  "pic",
  "related_search"
],
"geo_names": [
  
],
"social_domains": [
  "wikipedia",
  "reddit",
  "spotify"
],
"right_spelling": null,
"keyword_length": 4,
"lang": "en"
}

Example

Request data:


{
 "id": {{any_num_or_string}},
 "method": "SerpstatKeywordProcedure.getKeywords",
 "params": {
   "keyword": {{keyword}},
   "se": {{search_engine}},
   (optional) "minusKeywords": [{{keyword}}],
   (optional) "sort": { {{field}}: {{"asc"|"desc"}}},
   (optional) "filters": { {{field}}: {{value}}},
   (optional) "page": {{page}},
   (optional) "size": {{page_size}}
 }
}

Response data:


{
  "id": {{your_num_or_string}},
  "result": {
    "data": [
      {
        "keyword": "chrome google play music",
        "cost": 0,
        "concurrency": 14,
        "found_results": 312000000,
        "region_queries_count": 10,
        "region_queries_count_wide": 0,
        "types": [
          "pic",
          "related_search"
        ],
        "geo_names": [
          
        ],
        "social_domains": [
          "wikipedia",
          "reddit",
          "spotify"
        ],
        "right_spelling": null,
        "keyword_length": 4,
        "lang": "en"
      },
      {
        "keyword": "google play music эквалайзер",
        "cost": 0,
        "concurrency": 8,
        "found_results": 0,
        "region_queries_count": 10,
        "region_queries_count_wide": 0,
        "region_queries_count_phrase": 0,
        "types": [
          
        ],
        "geo_names": [
          
        ],
        "social_domains": [
          
        ],
        "right_spelling": null,
        "keyword_length": 4,
        "lang": "",
      },
      ................................................
    ],
    "summary_info": {
      "page": 1,
      "left_lines": 99268,
      "total": 3809
    }
  }
}