Похожие ключевые фразы V4 (SerpstatKeywordProcedure.getRelatedKeywords)

SerpstatKeywordProcedure.getRelatedKeywords — метод возвращает похожие ключевые фразы.

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

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

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

Параметр

cost

region_queries_count

concurrency

weight

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

Метрика	Описание
result	Инкапсулирует в себе ответ
total	Количество найденных похожих фраз
keyword	Похожая фраза
region_queries_count	Частотность ключевой фразы в выбранном регионе
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое )
right_spelling	Рекомендация к исправлению для ключевой фразы с орфографической ошибкой
weight	Сила связи похожих фраз
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
}

Example

Request data:


{
 "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}}
 }
}

Response data:


{
    "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
        }
    }
}