Подбор ключевых фраз
Метод 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": "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
}
{
"id": "1",
"method": "SerpstatKeywordProcedure.getKeywords",
"params": {
"keyword": "iphone",
"se": "g_us",
"minusKeywords": ["app", "apple"],
"filters": {"lang": "en"},
"sort": {"region_queries_count": "asc"},
"page": 1,
"size": 2
}
}
{
"id": "1",
"result": {
"data": [
{
"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
},
{
"keyword": "ihome ip37 portable stereo speaker case for ipod and iphone",
"cost": 0,
"concurrency": 0,
"found_results": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"types": [],
"geo_names": [],
"social_domains": [],
"right_spelling": null,
"lang": "en",
"keyword_length": 10,
"difficulty": 1
}
],
"summary_info": {
"page": 1,
"total": 6581896,
"left_lines": 999975
}
}
}
Шаблоны запросов к Serpstat API: ссылка