Возможности Решения Обновления Serpstat Блог Тарифы Поддержка
RU
EN RU UK

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

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
withIntents Интент ключевой фразы
Этот параметр работает только для баз данных g_ua и g_us		 boolean да false true | false
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;

intents_contain: ["informational", "navigational", "commercial", "transactional"];
intents_not_contain: ["informational", "navigational", "commercial", "transactional"]

Параметры ответа
Параметр Описание
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
 Количество ключевых фраз
intents
 Интенты анализируемой ключевой фразы
summary_info Объект с данными ответа
page Номер страницы
left_lines Количество оставшихся API строк

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

{
      "region_queries_count": 1220000,
      "region_queries_count_wide": 1000000,
      "cost": 1.43,
      "concurrency": 100,
      "keyword": "iphone",
      "found_results": 7450000000,
      "types": [
           "related_search",
           "pic"
      ],
      "geo_names": [],
      "social_domains": [
           "youtube",
           "amazon",
           "wikipedia",
           "reddit"
      ],
      "right_spelling": null,
      "difficulty": 76,
      "lang": "en",
      "suggestions_count": 0,
      "keywords_count": 54222
}

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"] — массив исключающих ключевых фраз 
withIntents Интент ключевой фразы
Этот параметр работает только для баз данных g_ua и g_us		 boolean да false true | false
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

Интенты:
"intents_contain" — Содержит один или несколько интентов, informational, navigational, commercial, transactional;

"intents_not_contain" — Не содержит один или несколько интентов, informational, navigational, commercial, transactional
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 Язык ключевой фразы
intents Интенты анализируемой ключевой фразы
keyword_length Количество слов, разделенных пробелом в ключевой фразе
difficulty Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
summary_info Объект с данными ответа
page Номер страницы
total Количество найденных вариаций ключевых фраз
left_lines Количество оставшихся API строк

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

{
      "keyword": "iphone c price canada",
      "cost": 0,
      "concurrency": 0,
      "found_results": 0,
      "region_queries_count": 1,
      "region_queries_count_wide": 0,
      "types": [
           "also_asks",
           "a_box_fsnippet"
      ],
      "geo_names": [
           "canada"
      ],
      "social_domains": [
           "youtube",
           "wikipedia"
      ],
      "right_spelling": "iphone x price canada",
      "lang": "en",
      "keyword_length": 4
}

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 (список поисковых баз)
withIntents Интент ключевой фразы
Этот параметр работает только для баз данных g_ua и g_us		 boolean да false true | false
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
intents_contain Содержит один или несколько интентов array informational, navigational, commercial, transactional
intents_not_contain Не содержит один или несколько интентов array informational, navigational, commercial, transactional

Параметры ответа
Параметр Описание
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)
intents
 Интенты анализируемой ключевой фразы
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": 26,
     "url": "https://amblerpizza.com/",
     "url_keywords_count": 741,
     "domain": "amblerpizza.com",
     "domain_visibility": 0.070000000000000007,
     "domain_keywords_organic": 2360,
     "domain_keywords_ppc": 0,
     "domain_top_10_keywords_count": 145,
     "domain_sdr": 30,
     "domain_in_urls_count": 191,
     "domain_in_domains_count": 53,
     "domain_out_urls_count": 3619,
     "domain_out_domains_count": 16
}

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

Поделитесь статьей с вашими друзьями

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.