Switch to english interface?

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

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 да

Сила связи похожих фраз:
"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 строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа 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-анализ - Поисковые подсказки, Поисковые вопросы».

Параметры запроса
Параметр Описание Опциональный Варианты значений
id Идентификатор запроса: ответ будет содержать этот же идентификатор. Ввод числового (number) или текстового (string) значения. нет 1, test
method Название метода API нет SerpstatKeywordProcedure.exportKeywordsPhrase
params Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] нет
keyword Ключевая фраза нет "iphone 13"
se Идентификатор поисковой базы, по которой будет проходить поиск. нет g_us
size

Количество результатов на страницу в ответе

(min: 1, max: 1000)

да "size": "10"
page Номер страницы в ответе да "page": "5"
withQuestions С/без фраз, содержащих вопросительные слова в отчете да true, false
filters Условия фильтрации да

Пример ответа

Search suggestion Question
почему блогеры остались без работы почему?
какой медосмотр нужен для работы в польше какой?
выплаты кто потерял работу во время войны кто?
сколько нужно денег чтобы поехать в англию на работу сколько?
что делать если прогулял работу 2 дня что?


 За 1 строку ответа списывается 1 API лимит.

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

Телефон

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

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

Открыть чат технической поддержки