Поисковые подсказки по ключевой фразе V4 (SerpstatKeywordProcedure.getSuggestions)

SerpstatKeywordProcedure.getSuggestions — метод выполняет полнотекстовый поиск по поисковым подсказкам.

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

Название параметра	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
keyword	Фраза, для которой будет происходить поиск	string	нет		купить машину
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
page	Номер страницы в ответе	int	да	1	5
size	Количество результатов на страницу в ответе	int	да	100	50-1000

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

Метрики	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных поисковых подсказок
keyword	Поисковая подсказка
geo_names	Список топонимов в масcиве, если топоним присутствует в ключевой фразе. Если нет — маcсив пустой.
left_lines	Количество оставшихся API строк

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

{
"keyword": "beardedspice google play music",
"geo_names": [
]
}

Example

Request data:


{
 "id": {{any_num_or_string}},
 "method": "SerpstatKeywordProcedure.getSuggestions",
 "params": {
   "keyword": {{keyword}},
   "se": {{search_engine}},
   (optional) "page": {{page}},
   (optional) "size": {{page_size}}
 }
}

Response data:


{
  "id": {{your_num_or_string}},
  "result": {
    "data": [
      {
        "keyword": "beardedspice google play music",
        "geo_names": [
          
        ]
      },
      {
        "keyword": "gplayer for google play music",
        "geo_names": [
          
        ]
      },
      {
        "keyword": "gift card for google play music",
        "geo_names": [
          
        ]
      },
      ................................................
    ],
    "summary_info": {
      "page": 1,
      "left_lines": 99268,
      "total": 3809
    }
  }
}