Похожие ключевые фразы V4 (SerpstatKeywordProcedure.getRelatedKeywords)
SerpstatKeywordProcedure.getRelatedKeywords — метод возвращает похожие ключевые фразы.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
keyword | Фраза для которой будет происходить поиск ключевых слов | string | нет | купить машину | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
filters | Условия фильтрации | array | да |
Сила связи похожих фраз {"weight": {{weight_from}} |
|
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да |
{ cost: {{"asc"|"desc"}}} |
|
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 | 50-1000 |
Сортировка результатов возможна по следующим поля:
Параметр |
cost |
region_queries_count |
concurrency |
weight |
Метрики ответа:
Метрика | Описание |
Инкапсулирует в себе ответ | |
Количество найденных похожих фраз | |
Похожая фраза | |
region_queries_count | Частотность ключевой фразы в выбранном регионе |
cost | Цена за клик, $ |
concurrency | Конкуренция ключевой фразы в PPC (0-100) |
geo_names | Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой. |
types | Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ) |
right_spelling | Рекомендация к исправлению для ключевой фразы с орфографической ошибкой |
Сила связи похожих фраз | |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"keyword": "как телевизор купить",
"region_queries_count": 10,
"cost": 0,
"concurrency": 0,
"geo_names": [],
"types": [
"related_search",
"pic",
"also_asks",
"snip_breadcrumbs"
],
"right_spelling": null,
"weight": 6
}
{
"id": {{any_num_or_string}},
"method": "SerpstatKeywordProcedure.getRelatedKeywords",
"params": {
"keyword": {{keyword}},
"se": {{search_engine}},
(optional) "filters": {"weight": {{weight_from}}},
(optional) "sort": { {{field}}: {{"asc"|"desc"}}},
(optional) "page": {{page}},
(optional) "size": {{page_size}}
}
}
{
"id": {{your_num_or_string}},
"result": {
"data": [
{
"keyword": "как телевизор купить",
"region_queries_count": 10,
"cost": 0,
"concurrency": 0,
"geo_names": [],
"types": [
"related_search",
"pic",
"also_asks",
"snip_breadcrumbs"
],
"right_spelling": null,
"weight": 6
},
{
"keyword": "купить тв",
"region_queries_count": 390,
"cost": 0.1,
"concurrency": 92,
"geo_names": [],
"types": [
"video",
"ads_bot",
"ads_top",
"related_search",
"snip_breadcrumbs"
],
"right_spelling": null,
"weight": 6
},
........................
........................
],
"summary_info": {
"page": 1,
"left_lines": 99268,
"total": 3809
}
}
}