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

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

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

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

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

Параметры запроса
Параметр	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	нет		1, test
method	Название метода API	string	нет		SerpstatKeywordProcedure.getKeywordsInfo
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	нет
keywords	Массив фраз, для которых будет происходить поиск	array	нет		["iphone", "iphone 11"] максимум 1000 ключевых фраз в массиве
se	Идентификатор поисковой базы, по которой будет проходить поиск.	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	да		варианты фильтрации перечислены в таблице ниже
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

---

Параметры фильтрации
Параметр	Описание	Тип данных	Варианты значений
cost	Стоимость за клик (в США $; точное совпадение)	float	любое числовое значение
cost_from	Стоимость за клик (в США $; точное совпадение) от	float	любое числовое значение
cost_to	Стоимость за клик (в США $; точное совпадение) до	float	любое числовое значение
concurrency	Конкуренция (насколько сложно продвижение фразы в топ от 1-100)	int	любое целое число в диапазоне 1-100
concurrency_from	Конкуренция (насколько сложно продвижение фразы в топ от 1-100) от	int	любое целое число в диапазоне 1-100
concurrency_to	Конкуренция (насколько сложно продвижение фразы в топ от 1-100) до	int	любое целое число в диапазоне 1-100
keyword_length	Количество слов в ключевой фразе	int	любое числовое значение
keyword_length_from	Количество слов в ключевой фразе от	int	любое числовое значение
keyword_length_to	Количество слов в ключевой фразе до	int	любое числовое значение
difficulty	Сложность ключевой фразы	float	любое числовое значение
difficulty_from	Сложность ключевой фразы от	float	любое числовое значение
difficulty_to	Сложность ключевой фразы до	float	любое числовое значение
region_queries_count	Частотность ключевой фразы в выбранном регионе	int	любое целое число
region_queries_count_from	Частотность ключевой фразы в выбранном регионе от	int	любое целое число
region_queries_count_to	Частотность ключевой фразы в выбранном регионе до	int	любое целое число
right_spelling	Отображать или не отображать ключевые слова с неправильным написанием	boolean	true или false
keyword_contain	Содержит все ключевые фразы (точное соответствие)	string	любое текстовое значение
keyword_not_contain	Не содержит все ключевые фразы (точное соответствие)	string	любое текстовое значение
keyword_contain_one_of	Содержит одну ключевую фразу из (точное соответствие)	string	любое текстовое значение
keyword_not_contain_one_of	Не содержит одну ключевую фразу из (точное соответствие)	string	любое текстовое значение
keyword_contain_broad_match	Содержит все ключевые фразы (широкое соответствие)	string	любое текстовое значение
keyword_not_contain_broad_match	Не содержит все ключевые фразы (широкое соответствие)	string	любое текстовое значение
keyword_contain_one_of_broad_match	Содержит одну ключевую фразу из (широкое соответствие)	string	любое текстовое значение
keyword_not_contain_one_of_broad_match	Не содержит одну ключевую фразу из (широкое соответствие)	string	любое текстовое значение
weight	Сила связи	string	"weight_from" или "weight_to"
geo_names	Массив топонимов, если топоним присутствует в ключевом слове	string	"contain" или "not_contain"
types	Тип специальных элементов на выходе	array	Список возможных значений для types

---

Параметры ответа
Параметр	Описание
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 строк

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

{
    "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 строк

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

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

4.9. Страницы-лидеры

Метод SerpstatDomainProcedure.getTopUrls возвращает список страниц различных сайтов, которые релевантны искомой ключевой фразе и получают больше всего трафика как по этой фразе, так и по группе связанных фраз.
Аналогичен отчету «Страницы-лидеры» в Анализе ключевых слов.

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

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	да		Любое текстовое или числовое значение. Например: 1, test, тест
method	Название метода API	string	да		SerpstatDomainProcedure.getTopUrls
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	да
keyword	Фраза, для которой будет происходить поиск	string	да		Любое текстовое значение. Например: "rebook"
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	да		g_us
page	Номер страницы	int	нет	1	Любое числовое значение
page_size	Количество результатов в ответе	int	нет	20	Текстовое значение. Варианты значений: 20, 50, 100, 200, 500
sort	Сортировка по данным	string	нет	keywords	"keywords" — Сортировка по количеству ключевых слов
order	Направление сортировки	string	нет	desc	"desc" — Сортировка по убыванию, "asc" — Сортировка по возрастанию

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
urls	Массив с данными ответа
url	URL искомой фразы
keywords	Общее количество ключевых фраз, по которым ранжируется страница в Google топ-100
traff	Ориентировочный трафик страницы по ключевому слову в зависимости от частотности ключа и позиции домена.
fbShares	Количество шейров (репостов) в социальной сети Facebook
summary_info	Объект с общими данными ответа
left_lines	Количество оставшихся API строк
keyword	Анализируемая фраза
se	Используемая поисковая база
page	Номер страницы
page_size	Размер страницы
sort	Сортировка запроса
order	Направление сортировки запроса
total_urls	Общее количество найденных результатов

Лимиты: за 1 запрос снимается 1 лимит API.

4.97. Експорт поисковые вопросы и подсказки

Метод SerpstatKeywordProcedure.exportSuggestions экспортирует в .csv файл поисковые подсказки и вопросы для искомого ключевого слова. Данные аналогичны отчету из раздела «‎Анализ ключевых фраз - SEO-анализ - Поисковые подсказки, Поисковые вопросы».

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

Параметры запроса
Параметр	Описание	Тип данных	Обязательный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения.	int/string	да		1, test
method	Название метода API	string	да		SerpstatKeywordProcedure.exportKeywordsPhrase
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	array	да
keyword	Ключевая фраза	string	да		"iphone 13"
se	Идентификатор поисковой базы, по которой будет проходить поиск.	string	да		g_us
filters	Условия фильтрации	array	нет		"difficulty": 2 - Сложность ключевой фразы "difficulty_from": 1 "difficulty_to": 5 "cpc": 0.17 - Стоимость ключевой фразы (в US $; точное значение) "cpc_from": 0.08 "cpc_to": 0.97 "region_queries_count": 1000 - Частотность ключевой фразы в выбранном регионе "region_queries_count_from": 480 "region_queries_count_to": 1900 "keyword": "apple 10" - Фильтрация по ключевому слову "keyword_length": 3 - Длина ключевой фразы "keyword_length_from": 1 "keyword_length_to": 5 "questions": Список допустимых вопросов для каждого региона
withQuestions	С/без фраз, содержащих вопросительные слова в отчете	string	нет		"true" - с вопросами, "false" - без вопросов
size	Количество результатов на страницу в ответе (min: 1, max: 1000)		нет	500	"size": "10"
page	Номер страницы в ответе		нет	1	"page": "5"

Параметры ответа
Параметр	Описание
keyword	Ключевая фраза
question	Вопросительное слово фразы

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

"what do apple seeds need to germinate","what,do"

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

Метод 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 строк

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

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