Схожі ключові фрази

Метод SerpstatKeywordProcedure.getRelatedKeywords повертає пошукові запити, які пов'язані з аналізованою ключовою фразою семантично. Аналогічний до звіту Аналіз ключових слів / Схожі фрази.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Доступні пошукові бази

Параметри запиту
Параметр	Опис	Тип даних	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор.	int/string	ні		Текстове чи числове значення
method	Назва методу API	string	ні		SerpstatKeywordProcedure.getRelatedKeywords
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	array	ні
keyword	Фраза, для якої буде відбуватися пошук	string	ні		iphone
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	string	ні		Например: g_us (список пошукових баз)
filters	Умови фільтраціі	array	так		Сила звʼязку схожих фраз: "weight":{weight_from} — Сила звʼязку від "weight":{weight_to} — Сила звʼязку до Фрази з неправильним написанням: "right_spelling":true — Містить всі "right_spelling":false — Не містить всі Частотність: "region_queries_count": 1 — Частотність ключової фрази у вибраному регіоні "region_queries_count_to": 2 — Частотність ключової фрази у вибраному регіоні до "region_queries_count_from": 3 — Частотність ключової фрази у вибраному регіоні від Складність: "difficilty": 1 (0-100) — Складність фрази "difficilty_to": 5 (0-100) — Складність фрази до "difficilty_from": 1 (0-100) — Складність фрази від Конкуренція: "concurrency": 1 (1-100) — Конкуренція "concurrency_to": 10 (1-100) — Конкуренція до "concurrency_from": 1 (1-100) — Конкуренція від Вартість: "cost": 1 (0-200) — Вартість ключової фрази в $ "cost_from": 1 (0-200) — Вартість від в $ "cost_to": 10 (0-200) — Вартість до в $ Кількість слів у фразі: "keyword_length": 1 (будь-яке числове значення) — Кількість слів в ключовій фразі "keyword_length_to": 10 (будь-яке числове значення) — Кількість слів в ключовій фразі до "keyword_length_from": 1 (будь-яке числове значення) — Кількість слів в ключовій фразі від Топоніми: "geo_names": "contain" \| "not_contain" — Масив топонімів, якщо топонім присутній в ключовій фразі ( містить \| не містить ) Спец-елементи: "types": ["snip_also_ask", "sport", "news"] — Тип спец-елементів у видачі (наприклад: також шукають, спортивні події, новини і т.д.) Доступні значення для types: map, pic, video, news, adv, calc, spec, graph, market, island, answer, carousel, sponsored, also_asks, map_local, a_box_c_converter, a_box_card, a_box_color_picker, a_box_dictionary, a_box_dtime, a_box_earthquake, a_box_flights, a_box_fsnippet, a_box_g_converter, a_box_map, a_box_nutrition, a_box_population, a_box_some, a_box_sports, a_box_stock, a_box_translation, a_box_weather, a_box_when_is, ads_bot, ads_top, bests, car_loan_calc, discover_places, kn_graph_brand, kn_graph_card, kn_graph_carousel_list, kn_graph_carousel_table, kn_graph_disambiguation, kn_graph_health, kn_graph_hotel_booking, kn_graph_local, local_pack, mortgage_calc, refine_by_brand, related_search, research, shopping_rhs, shopping_top, shopping_bottom, snip_breadcrumbs, snip_doc_type, snip_https, snip_image_thumbnail, snip_info, snip_reviews_stars, snip_search_box, snip_sitelinks, snip_twitter, snip_video_thumbnail, snip_feedback, snip_also_ask, snippet_steps_list, prices, top_stories, adv_banner, afisha, auto, avia, collections, companies, converter, entity, fact, homonyms, math, metro, music, oplata, pogoda, radio, rasp, realty, related, snippet_dates, snippet_file, snippet_image, snippet_recipe, snippet_list, snippet_price, snippet_rating, snippet_redir, snippet_showcase, snippet_sitelinks, snippet_social, snippet_table, snippet_video, sport, taxi, time, translate, travel, tv. (детальніше про спец-елементи SERP) Ключові фрази: "keyword_contain": string — Містить все (точна відповідність) "keyword_not_contain": string — Не містить все (точна відповідність) "keyword_contain_one_of": array — Містить один з (точна відповідність) "keyword_not_contain_one_of": array — Не містить один з (точна відповідність) "keyword_contain_broad_match": array — Містить все (широка відповідність) "keyword_not_contain_broad_match": array — Не містить все (широка відповідність) "keyword_contain_one_of_broad_match": array — Містить один з (широка відповідність) "keyword_not_contain_one_of_broad_match": array — Не містить один з (широка відповідність) Мова: "lang": {uk,ru,en,bg,pl,de,es,it,fr,ro,be,hu,ka,el...} — Мова ключової фрази Фільтрація за мовою доступна тільки для g_ua бази
sort	Сортування за даними (за зростанням і спаданням)	array	так	"keyword"	"keyword" — Сортування результатів за абеткою "weight" — Сортування результатів за кількістю URL у топ-20 видачі "difficulty" — Сортування результатів за рівнем конкуренції ключової фрази для просування в топ-10 "cost" — Сортування результатів за ціною за клік (у доларах США)
order	Напрямок сортування	array	так	"desc"	Напрямок сортування (asc — за зростанням, desc — за спаданням)
page	Номер сторінки у відповіді	int	так	1	"page": 5 (будь-яке числове значення)
size	Кількість результатів на сторінку у відповіді	int	так	100	"size": 10 (будь-яке числове значення) min: 1, max: 1000

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними
keyword	Схожа ключова фраза
region_queries_count	Частотність ключової фрази в обраному регіоні
cost	Ціна за клік, $ (показник оновлюється щомісяця)
concurrency	Конкуренція ключевої фрази в PPC (0-100%)
geo_names	Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
types	Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше).
right_spelling	Рекомендація до виправлення для ключової фрази з орфографічною помилкою
weight	Кількість URL в топ-20 видачі, які ранжуються за аналізованою фразою та фразою зі звіту.
difficulty	Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 1 до 100)
summary_info	Об'єкт з даними відповіді
page	Номер сторінки
total	Кількість знайдених схожих фраз
left_lines	Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. За допомогою API запитів ви можете отримати лише перші 60000 результатів, незалежно від кількості та обсягу самих запитів. Для отримання більшої кількості даних - скористайтесь опцією експорту в розділах Аналіз домену, Аналіз ключової фрази або Аналіз URL, або зверніться до куратора за персональним вивантаженням результатів. Частина відповіді API, за яку знімається 1 ліміт:

     {
            "6 plus portrait dimensions": {
                "keyword": "6 plus portrait dimensions",
                "region_queries_count": 1,
                "cost": 0,
                "concurrency": 0,
                "geo_names": [],
                "types": [
                    "also_asks",
                    "video",
                    "related_search",
                    "snip_breadcrumbs"
                ],
                "right_spelling": null,
                "weight": 1,
                "difficulty": null
            }

Example

Request data:

{
    "id": 1,
    "method": "SerpstatKeywordProcedure.getRelatedKeywords",
    "params": {
        "keyword": "seo",
        "se": "g_us",
        "filters": {
            "keyword_contain": "competitor",
            "types": "also_asks"
            },
        "sort": {"keyword":"asc"},
        "page": 1,
        "size": 3
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "keyword": "how to competitor website analysis in hindi",
                "region_queries_count": 1,
                "cost": 0,
                "concurrency": 0,
                "geo_names": [],
                "types": [
                    "also_asks",
                    "related_search",
                    "snip_breadcrumbs"
                ],
                "right_spelling": null,
                "weight": 1,
                "difficulty": 11.026413636841786
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 1,
            "left_lines": 994613
        }
    }
}