Анализ ключевых слов
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 | Порядок сортировки результатов в формате: | array | да | [ ] пустой массив | {"cost": "desc"} | |
filters | Условия фильтрации | array | да | "right_spelling": true$ "right_spelling": false "minus_keywords": ["case", "red"] "cost": "10"; "concurrency": "7"; "found_results": "100"; "region_queries_count": "1000"; "region_queries_count_wide": "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 | Язык |
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 | да | Стоимость: Частотность: Количество слов во фразе: Сложность фразы: Конкуренция: Фразы с неправильным написанием: | |
sort | Сортировка по данным (по возрастанию и убыванию) | array | да | "cost": "asc" "region_queries_count": "desc" | "keyword_length" — Сортировка результатов по длине ключевых фраз |
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 | да | Сила связи похожих фраз: Фразы с неправильным написанием: Частотность: Доступные значения для 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) Ключевые фразы: Язык: | |
sort | Сортировка по данным (по возрастанию и убыванию) | array | да | "keyword" | "keyword" — Сортировка результатов по алфавиту |
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.getKeywordTop возвращает последний топ-100 Google по ключевой фразе. Аналогичен отчету Топ по фразе в Анализе ключевых фраз.
Общие параметры запроса и инструкция по использованию 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 "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"
]
},
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 | Порядок сортировки результатов в формате: | 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; "traff": 300; "relevance": 5; "our_relevance": 11 |
Параметры ответа | |
Параметр | Описание |
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 | Порядок сортировки результатов в формате: | 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 "region_queries_count": "1000"; "region_queries_count_wide": "1000"; "position": 1 "cost": "10"; "concurrency": "7"; "difficulty": 3; |
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
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 | Порядок сортировки результатов в формате: order - направление сортировки (asc — по возрастанию, desc — по убыванию) | да | {"relevance":"desc"} | {"ads":"desc"} |
page | Номер страницы в ответе | да | 1 | "page": "1" |
size | Количество результатов на страницу в ответа | да | 100 | "size": "50" |
Параметры ответа | |
Параметр | Описание |
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
},