Похожие ключевые фразы

Метод SerpstatKeywordProcedure.getRelatedKeywords возвращает похожие запросы, т.е. поисковые запросы, которые связаны с искомой ключевой фразой семантически. Аналогичен отчету Анализ ключевых фраз / Похожие фразы.

Общие параметры запроса и инструкция по использованию Serpstat API

Перечень доступных баз и стран

Параметры запроса
Параметр	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор.	int/string	нет		Текстовое или числовое значение
method	Название метода API	string	нет		SerpstatKeywordProcedure.getRelatedKeywords
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keyword	Фраза для которой будет происходить поиск ключевых слов	string	нет		Любое текстовое значение (Например "seo")
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": 1 (любое числовое значение)
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 результатов, вне зависимости от количества и объема самих запросов. Для получения большего количества данных - воспользуйтесь опцией экспорта в разделах Анализа домена, Анализа ключевой фразы или Анализа Страниц, либо обратитесь к куратору за персональной выгрузкой результатов. Часть ответа 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
        }
    }
}