Поисковые подсказки по ключевой фразе 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": [
]
}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
}
}
}