Схожі ключові фрази V4 (SerpstatKeywordProcedure.getRelatedKeywords)

SerpstatKeywordProcedure.getRelatedKeywords - метод повертає схожі ключові фрази.

Параметри запиту:

Назва	Опис	Тип даних	Опціональний	Значение за замовчуванням	Варіанти значень
keyword	Фраза, для якої буде відбуватися пошук	string	ні		купити машину
se	Ідентифікатор пошукової бази, по якій буде проходити пошук	string	ні		g_ua, g_ru, ...
filters	Умови фільтраціі	array	так		Сила зв'язку схожих фраз {"Weight": {{weight_from}}
page	Номер сторінки у відповіді	int	так	1	5
size	Кількість результатів на сторінку у відповіді	int	так	100	50-1000

Сортування результатів можливо за такими полями:

Параметр

cost

region_queries_count

concurrency

weight

Параметри відповіді:

Метрики	Опис
result	Інкапсулює в собі відповідь
total	Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100 для Google і топ-50 для Яндекс.
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
        }
    }
}