Анализ ключевых слов

4.1. Суммарный отчет

Метод SerpstatKeywordProcedure.getKeywordsInfo возвращает данные по ключевому слову (частотность ключевой фразы в выбранном регионе, цена за клик, конкуренция ключевой фразы в PPC и т.п.). Аналогичен отчету «Суммарный отчет» в Анализе ключевых фраз, за вычетом графиков и диаграмм.

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

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

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

Параметр

Описание

Тип данных

Опциональный

Значение по умолчанию

Варианты значений

Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.

int/string

нет

1, test

method

Название метода API

string

нет

SerpstatKeywordProcedure.getKeywordsInfo

params

Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]

array

нет

keywords

Массив фраз, для которых будет происходить поиск

array

нет

["iphone", "iphone 11"]
максимум 1000 ключевых фраз в массиве

Идентификатор поисковой базы, по которой будет проходить поиск.

string

нет

g_us

sort

Порядок сортировки результатов в формате:
{{{field}}: {{order}}}

field — поле, по которому нужно выполнить сортировку (все числовые значения, кроме suggestions_count и keywords_count)

order — направление сортировки (asc — по возрастанию, desc — по убыванию)

array

да

[ ] пустой массив

{"cost": "desc"}

filters

Условия фильтрации

array

да

"right_spelling": true$ "right_spelling": false

"minus_keywords": ["case", "red"]

"cost": "10";
"cost_to": "10";
"cost_from": 1

"concurrency": "7";
"concurrency_to": "7";
"concurrency_from": 1

"found_results": "100";
"found_results_to": "500";
"found_results_from": 300

"region_queries_count": "1000";
"region_queries_count_to": "2000";
"region_queries_count_from": 300

"region_queries_count_wide": "1000";
"region_queries_count_wide_to": "1500";
"region_queries_count_wide_from": 100

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
keyword	Заданная ключевая фраза
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100%)
found_results	Количество найденных результатов по ключевой фразе
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
social_domains	Социальные домены, которые находятся в топ-10 по заданной фразе
right_spelling	Рекомендация к исправлению для ключевой фразы с орфографической ошибкой
lang	Язык
difficulty	Уровень конкуренции по фразе для продвижения в топ-10 в органике
suggestions_count	Количество поисковых подсказок
keywords_count	Количество ключевых фраз
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 1000 результатов. Часть ответа API, за которую снимается 1 лимит:

{
    "keyword": "iphone",
    "cost": 1.8822413793103445,
    "concurrency": 100,
    "found_results": 79,
    "region_queries_count": 1220000,
    "region_queries_count_wide": 0,
    "region_queries_count_phrase": 0,
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks"
        ],
    "geo_names": [],
    "social_domains": [
        "wikipedia",
        "amazon",
        "reddit"
        ],
    "right_spelling": null,
    "lang": null,
    "difficulty": 89.5890633703002,
    "suggestions_count": 2652668,
    "keywords_count": 8323766
},

4.2. Подбор ключевых фраз

Метод SerpstatKeywordProcedure.getKeywords представляет все вариации искомой ключевой фразы, по которым домены ранжируются в топ-100 органической выдачи Google, а также данные по найденным ключевым словам (количество запросов, стоимость за клик, уровень конкуренции и др.). Аналогичен отчету Анализ ключевых фраз - SEO-анализ - Подбор фраз.

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

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

Параметры запроса
Параметр	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор.	int/string	нет		Текстовое или числовое значение
method	Название метода API	string	нет		SerpstatKeywordProcedure.getKeywords
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keyword	Фраза, для которой будет происходить поиск	string	нет		"iphone" (Любое текстовое значение)
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	нет		g_us (список поисковых баз)
minusKeywords	Список минус-слов при поиске	array	да		["app", "apple"] — массив исключающих ключевых фраз
filters	Условия фильтрации	array	да		Стоимость: "cost": 10 (0-200) — Стоимость за клик в $ "cost_to": 10 (0-200) — Стоимость за клик до "cost_from": 1 (0-200) — Стоимость за клик от Частотность: "region_queries_count": 1000 (0-100,000,000) — Частотность ключевой фразы в выбранном регионе "region_queries_count_to": 2000 (0-100,000,000) — Частотность до "region_queries_count_from": 300 (0-100,000,000) — Частотность от Количество слов во фразе: "keyword_length": 1 — Количество слов в ключевой фразе "keyword_length_from" — Количество слов от "keyword_length_to" — Количество слов до Сложность фразы: "difficulty": 3 (0-100) — Сложность фразы "difficulty_from": 5 (0-100) — Сложность от "difficulty_to": 10 (0-100) — Сложность до Конкуренция: "concurrency": 7 (1-100) — Конкуренция "concurrency_to": 7 (1-100) — Конкуренция до "concurrency_from": 1 (1-100) — Конкуренция от Фразы с неправильным написанием: "right_spelling": true, "right_spelling": false — Фразы с неправильным написанием: Содержит все / Не содержит все Ключевые слова: "keyword_contain" — Содержит все (точное соответствие); "keyword_not_contain" — Не содержит все (точное соответствие); "keyword_contain_one_of" — Содержит один из (точное соответствие); "keyword_not_contain_one_of" — Не содержит один из (точное соответствие); "keyword_contain_broad_match" — Содержит все (широкое соответствие); "keyword_not_contain_broad_match" — Не содержит все (широкое соответствие); "keyword_contain_one_of_broad_match" — Содержит один из (широкое соответствие); "keyword_not_contain_one_of_broad_match" — Не содержит один из (широкое соответствие); Язык: "lang": {uk,ru,en,bg,pl,de,es,it,fr,ro,be,hu,ka,el,other} — Указать язык ключевой фразы Фильтрация по языку работает только для базы g_ua
sort	Сортировка по данным (по возрастанию и убыванию)	array	да	"cost": "asc" "region_queries_count": "desc"	"keyword_length" — Сортировка результатов по длине ключевых фраз "difficulty" — Сортировка результатов по уровню конкуренции ключевой фразы для продвижения в топ-10 "cost" — Сортировка результатов по цене за клик (в долларах США) "region_queries_count" — Сортировка результатов по частотности ключевой фразы в выбранном регионе
order	Направление сортировки	array	да	"cost": "asc" "region_queries_count": "desc"	Направление сортировки ключевых слов (asc — по возрастанию, desc — по убыванию)
page	Номер страницы в ответе	int	да	1	"page": 5 (любое числовое значение)
size	Количество результатов на страницу в ответе	int	да	100	"size": 10 (любое числовое значение) min: 1, max: 1000

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
keyword	Ключевая фраза
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100%)
found_results	Количество найденных результатов по ключевой фразе
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
social_domains	Социальные домены, которые находятся в топ-10 по заданной фразе
right_spelling	Рекомендация к исправлению для ключевой фразы с орфографической ошибкой
lang	Язык ключевой фразы
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
difficulty	Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
summary_info	Объект с данными ответа
page	Номер страницы
total	Количество найденных вариаций ключевых фраз
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных ключевых фраз в ответе. С помощью API запросов вы можете получить только первые 60000 результатов, вне зависимости от количества и объема самих запросов. Для получения большего количества данных - воспользуйтесь опцией экспорта в разделах Анализа домена, Анализа ключевой фразы или Анализа Страниц, либо обратитесь к куратору за персональной выгрузкой результатов. Часть ответа API, за которую снимается 1 лимит:

{
    "keyword": "how to download you tube videos on iphone",
    "cost": 0.56999999999999995,
    "concurrency": 1,
    "found_results": 729000000,
    "region_queries_count": 9900,
    "region_queries_count_wide": 0,
    "types": [
        "a_box_fsnippet",
        "local_related_search",
        "related_search"
        ],
    "geo_names": [],
    "social_domains": [
        "youtube",
        "reddit"
        ],
    "right_spelling": "how to download youtube videos on iphone",
    "lang": null,
    "keyword_length": 8,
    "difficulty": 17.57
},

4.3. Поисковые подсказки

Метод SerpstatKeywordProcedure.getSuggestions выполняет полнотекстовый поиск по поисковым подсказкам анализируемого ключевого слова. Аналогичен отчету Анализ ключевых фраз - SEO-анализ - Поисковые подсказки.

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

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

Параметры запроса
Параметр	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	нет		1, test
method	Название метода API	string	нет		SerpstatKeywordProcedure.getSuggestions
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keyword	Фраза, для которой будет происходить поиск	string	нет		купить машину
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	нет		g_us
page	Номер страницы в ответе	int	да	1	"page": "5"
size	Количество результатов на страницу в ответе	int	да	100	"size": "10" min: 1, max: 1000
filters	Условия фильтрации	array	да		"minus_keywords": ["case", "red"]

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Инкапсулирует в себе ответ
data	Массив с данными ответа
keyword	Поисковая подсказка
geo_names	Список топонимов в масcиве, если топоним присутствует в ключевой фразе. Если нет — маcсив пустой.
summary_info	Объект с данными ответа
page	Номер страницы
total	Количество найденных поисковых подсказок
left_lines	Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
    "keyword": "iphone x fre case release",
    "geo_names": []
},

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

Метод 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
            }

4.5. Топ по ключевой фразе

Метод SerpstatKeywordProcedure.getKeywordFullTop возвращает последний топ-100 Google по ключевой фразе. Аналогичен отчету «Топ по фразе» в Анализе ключевых слов.

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

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	да		1, test
method	Название метода API	string	да		SerpstatKeywordProcedure.getKeywordFullTop
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	да
keyword	Фраза, для которой будет происходить поиск	string	да		pizza
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	да		g_us
sort	Сортировка по данным (по возрастанию и убыванию)	array	нет	{"position": "asc"}	"position": "asc"/"desc" (asc — сортировка по возрастанию, desc — по убыванию) - Позиция в топ-100 "url": "asc"/"desc" - URL (asc - от A до Z; desc - от Z до A) "url_keywords_count": "asc"/"desc" - Количество ключей в URL "domain": "asc"/"desc" - Домен (asc - от A до Z; desc - от Z до A) "domain_visibility": "asc"/"desc" - Видимость "domain_keywords_organic": "asc"/"desc" - Количество ключей домена в органике "domain_keywords_ppc": "asc"/"desc" - Количество ключей домена в ррс "domain_top_10_keywords_count": "asc"/"desc" - Количество ключей домена в топ-10 "domain_sdr": "asc"/"desc" - Serpstat Domain Rank "domain_in_urls_count": "asc"/"desc" - Количество входящих ссылок домена "domain_in_domains_count": "asc"/"desc" - Количество ссылающихся доменов "domain_out_urls_count": "asc"/"desc" - Количество исходящих ссылок домена "domain_out_domains_count": "asc"/"desc" - Количество исходящих доменов
size	Количество результатов в ответе	int	нет	100	"size": "50" min: 10, max: 100

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
top	Массив с данными ответа
position	Позиция по ключевой фразе в поисковой выдаче
url	Страница, которая находится на указанной позиции
url_keywords_count	Количество ключевых слов в SEO, по которым URL-адрес попадает в топ-100 результатов Google.
domain	Домен, который ранжируется по ключевой фразе
domain_visibility	Видимость домена в топ-20 поисковых результатов. Показатель рассчитывается по соотношению количества и популярности ключевых фраз, по которым сайт ранжируется. Подробнее о показателе
domain_keywords_organic	Количество ключевых слов в SEO, по которым домен попадает в топ-100 результатов Google.
domain_keywords_ppc	Количество ключевых слов РРС, по которым домен попадает в топ-100 результатов Google.
domain_top_10_keywords_count	Количество ключевых слов в SEO, по которым домен попадает в топ-10 результатов Google.
domain_sdr	Serpstat Domain Rank (SDR) — показатель авторитетности домена
domain_in_urls_count	Количество входящих ссылок домена
domain_in_domains_count	Количество ссылающихся доменов
domain_out_urls_count	Количество исходящих ссылок домена
domain_out_domains_count	Количество исходящих доменов
summary_info	Объект с общими данными ответа
keywords	Количество ключевых слов в SEO (из отчета Подбор фраз)
frequency	Частотность ключевой фразы
cost	Цена за клик в $ США, которая ежемесячно обновляется
difficulty	Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
concurrency	Конкуренция ключевой фразы в PPC (0-100%)
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
sorting	Сортировка запроса
left_limits	Количество оставшихся API строк
count_top_results	Количество результатов по запросу
keyword	Анализируемая фраза
se	Используемый регион базы данных

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

{
  "position": 27,
  "url": "https://www.zpizza.com/",
  "url_keywords_count": 3162,
  "domain": "zpizza.com",
  "domain_visibility": 0.07,
  "domain_keywords_organic": 9120,
  "domain_keywords_ppc": 0,
  "domain_top_10_keywords_count": 1101,
  "domain_sdr": 44,
  "domain_in_urls_count": 6265,
  "domain_in_domains_count": 716,
  "domain_out_urls_count": 452,
  "domain_out_domains_count": 129
  }

4.6. Конкуренты в поисковой выдаче

Метод SerpstatKeywordProcedure.getCompetitors возвращает конкурентов по заданной ключевой фразе из топ-20 поисковой выдачи. Аналогичен отчету Анализ ключевых фраз - SEO-анализ - Конкуренты.

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

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

Параметры запроса
Параметр	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	нет		1, test
method	Название метода API	string	нет		SerpstatKeywordProcedure.getCompetitors
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keyword	Фраза для которой будет происходить поиск	string	нет		iphone
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	нет		g_us
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field — поле, по которому нужно выполнить сортировку: * visible * keywords * traff * visible_dynamic * keywords_dynamic * traff_dynamic * ads_dynamic * new_keywords * out_keywords * rised_keywords * down_keywords * ad_keywords * ads * intersected * relevance * our_relevance order — направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	[ ] пустой массив	{"keyword": "desc"} или {"visible": "asc"}
size	Количество результатов на страницу в ответе	int	да	100	"size": "10" min: 1, max: 1000
filters	Условия фильтрации	array	да		"domain": www.apple.com "minus_domain": www.blackberry.com "visible": 30; "visible_from": 20; "visible_to": 100 "traff": 300; "traff": 500; "traff": 1000 "relevance": 5; "relevance_from": 25; "relevance_to": 30 "our_relevance": 11 "our_relevance_from": 25; "our_relevance_to": 30

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
domain	Домен
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Ориентировочный трафик по ключевому слову в зависимости от частоты ключевика и позиции
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз по сравнению с последней датой обновления
traff_dynamic	Изменение трафика по сравнению с последней датой обновления
ads_dynamic	Изменение количества ключевых фраз в контекстной рекламе
new_keywords	Количество новых ключевых фраз, которые появились у домена по сравнению с последней датой обновления
out_keywords	Количество ключевых фраз, которые потерял домен по сравнению с последней датой обновления
rised_keywords	Ключевые фразы, по которым выросли позиции по сравнению с последней датой обновления
down_keywords	Ключевые фразы, по которым упали позиции по сравнению с последней датой обновления
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений
intersected	Количество фраз у домена, которые содержат искомую фразу
relevance	Общая релевантность домена к искомой фразе
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:

{
"apple.com": {
    "domain": "apple.com",
    "visible": 3417.2564,
    "keywords": 46650466,
    "traff": 1998603882,
    "visible_dynamic": 6.359480000000076,
    "keywords_dynamic": -751,
    "traff_dynamic": 7691041,
    "ads_dynamic": -390,
    "new_keywords": 153290,
    "out_keywords": 154041,
    "rised_keywords": 453556,
    "down_keywords": 465903,
    "ad_keywords": 5422,
    "ads": 4018,
    "intersected": 829984,
    "relevance": 1.78,
    "our_relevance": 9.97
},

4.7. Рекламные объявления

Метод SerpstatKeywordProcedure.getAdKeywords выполняет поиск ключевых слов в платной выдаче и рекламных объявлений по ключевой фразе. Аналогичен отчету Анализ ключевых фраз - РРC-анализ - Рекламные объявления.

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

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

Параметры запроса
Название	Описание	Тип	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	нет		1, test
method	Название метода API	string	нет		SerpstatKeywordProcedure.getAdKeywords
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keyword	Фраза, для которой будет происходить поиск	string	нет		iphone
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	нет		g_us
domains	Список доменов	array	да	[]	["apple.com","verizon.com"]
MinusKeywords	Список минус-слов при поиске	array	да	[]	["app", "apple"]
filters	Условия фильтрации	json object	да		{"queries_from": 10} {"queries_to": 10}
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field — поле, по которому нужно выполнить сортировку: * keyword_length * position * type * cost * concurrency * found_results * region_queries_count * region_queries_count_wide order — направление сортировки (asc — по возрастанию, desc — по убыванию)	json object	да	{"position": "asc", "region_queries_count":"desc"}	{"cost": "asc"}
page	Номер страницы в ответе	int	да	1	"page": "5"
size	Количество результатов на страницу в ответе	int	да	100	"size": "10" min: 1, max: 1000
filters	Условия фильтрации	array	да		"right_spelling": true; "right_spelling": false minus_domain : www.domain.com subdomain : blog.domain.com url (exact_url) : https://www.apple.com/airpods/ types : "carousel", "also_asks" keyword_length : num keyword_length_from : num keyword_length_to : num "region_queries_count": "1000"; "region_queries_count_to": "2000"; "region_queries_count_from": 300 "region_queries_count_wide": "1000"; "region_queries_count_wide_to": "1500"; "region_queries_count_wide_from": 100 "position": 1 "position_from": 2 "position_to": 10 "cost": "10"; "cost_to": "10"; "cost_from": 1 "concurrency": "7"; "concurrency_to": "7"; "concurrency_from": 1 "difficulty": 3; "difficulty_from": 5; "difficulty_to": 10

Для фильтрации результатов используйте следующие параметры:

Параметр	Описание	Возможные значения
queries_from	Минимальная частотность в месяц	0-100000000
queries_to	Максимальная частотность в месяц	0-100000000
position_from	Минимальная позиция	1-100
position_to	Максимальная позиция	1-100
cost_from	Минимальная стоимость за клик	0-200
cost_to	Максимальная стоимость за клик	0-200
concurrency_from	Минимальное значение конкуренции ключевой фразы в PPC	1-100
concurrency_to	Максимальное значение конкуренции ключевой фразы в PPC	1-100
results_from	Минимальное значение результатов	0-100000000
results_to	Максимальное значение результатов	0-100000000
length_from	Минимальное значение длины фразы	0-100000000
length_to	Максимальное значение длины фразы	0-100000000

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
keyword	Ключевая фраза, по которой отображается объявление
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
domain	Домен
subdomain	Поддомен
url	Url объявления, который отображается в поисковой выдаче по данному запросу
title	Заголовок объявления
text	Текст объявления, который отображается в поисковой выдаче по данному запросу
position	Позиции объявлений в контекстной рекламе
type	Место размещения объявления в SERP (1 - над; 2 - под; 3 - справа)
cost	Цена за клик, $
concurrency	Конкурентность в контекстной рекламе (0-100%)
found_results	Количество найденных результатов по ключевой фразе
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
geo_names	Список топонимов в масиве, если топоним присутствует в ключевой фразе. Если нет — масив пустой.
difficulty	Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
summary_info	Объект с данными ответа
page	Номер страницы
total	Количество найденных ключевых фраз в РРС по ключевой фразе
left_lines	Количество оставшихся API строк

{
    "keyword": "upgrade iphone x to xs",
    "keyword_length": 5,
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "url": "https://www.apple.com/iphone/",
    "title": "Trade in for iPhone 12 - Apple Official Site",
    "text": "Get $90 - $515 off iPhone 12 when you trade in an iPhone 7 or newer. Terms apply. A14 Bionic Chip. 5G speed. Ceramic Shield. Super Retina XDR display. Services: Free no-contact delivery, Finance with Apple Card, 3% cash back w/Apple Card, Prepaid mail-in kit.",
    "position": 2,
    "type": "1",
    "cost": 0,
    "concurrency": 50,
    "found_results": 325000000,
    "region_queries_count": 10,
    "region_queries_count_wide": 0,
    "types": [
        "carousel",
        "also_asks",
        "video",
        "ads_top"
        ],
    "geo_names": [],
    "difficulty": null
},

4.8. Конкуренты в платной выдаче

Метод SerpstatDomainProcedure.getAdsCompetitors возвращает список доменов-конкурентов в платной выдаче. Аналогичен отчету «Конкуренты» в PPC-анализе по домену.

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

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

Параметры запроса
Параметр	Описание	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	нет		1, test
method	Название метода API	нет		SerpstatDomainProcedure.getAdsCompetitors
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	нет
domain	Имя домена	нет		nike.com
se	Идентификатор поисковой базы, по которой будет проходить поиск.	нет		g_us
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку: * ads * keywords * intersected * missing_keywords order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"relevance":"desc"}	{"ads":"desc"}
page	Номер страницы в ответе	да	1	"page": "1"
size	Количество результатов на страницу в ответа	да	100	"size": "50" min: 50, max: 1000

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
domain	Домен
keywords	Количество ключевых фраз, которые использует конкурент в контекстной рекламе
ads	Количество рекламных объявлений
intersected	Количество ключевых фраз, по которым и анализируемый домен, и конкурент размещают платные объявления
missing_keywords	Количество ключей, по которым размещает объявления конкурент и которые отсутствуют у анализируемого домена
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

{
    "domain": "finishline.com",
    "keywords": 495,
    "ads": 453,
    "intersected": 57,
    "missing_keywords": 438
},

4.88. Топ по ключевой фразе (устаревший)

Метод SerpstatKeywordProcedure.getKeywordTop возвращает последний топ-100 Google по ключевой фразе.

Это устаревший запрос. Пожалуйста, воспользуйтесь актуальным API запросом Топа по фразе по этой ссылке.

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

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

Параметры запроса
Параметр	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	нет		1, test
method	Название метода API	string	нет		SerpstatKeywordProcedure.getKeywordTop
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keyword	Фраза, для которой будет происходить поиск	string	нет		iphone
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	нет		g_us
filters	Условия фильтрации	int	да	{"top_size": 100}	"top_size": 100 "position": 1 "position_from": 2 "position_to": 10 "url": https://www.apple.com/iphone/ "exact_url": https://www.apple.com/iphone-13-pro/ "domain": www.apple.com "minus_domain": www.blackberry.com "subdomain": developer.apple.com

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
top	Содержит результат
position	Позиция по ключевой фразе в поисковой выдаче
url	Страница, которая находится на указанной позиции
domain	Домен, который ранжируется по ключевой фразе
subdomain	Поддомен сайта, который отображается в поисковой выдаче по заданной фразе
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
ads	Содержит результаты контекстной рекламы (если она есть)
results	Количество результатов
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

{
    "position": 1,
    "url": "https://www.apple.com/iphone/",
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks",
        "snip_breadcrumbs"
        ]
},