Подбор ключевых фраз
Метод SerpstatKeywordProcedure.getKeywords представляет все вариации искомой ключевой фразы, по которым домены ранжируются в топ-100 органической выдачи Google или топ-50 Яндекс, а также данные по найденным ключевым словам (количество запросов, стоимость за клик, уровень конкуренции и др.). Аналогичен отчету Анализ ключевых фраз - SEO-анализ - Подбор фраз.
Общие параметры запроса и инструкция по использованию Serpstat API
Перечень доступных баз и стран
Параметры запроса | |||||
---|---|---|---|---|---|
Параметр | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
id | Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения. | int/string | нет | 1, test | |
method | Название метода API | string | нет | SerpstatKeywordProcedure.getKeywords | |
params | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] | array | нет | ||
keyword | Фраза, для которой будет происходить поиск | string | нет | iphone | |
se | Идентификатор поисковой базы, по которой будет проходить поиск (доступны базы Google и Yandex на выбор, пример: g_us, y_157). | string | нет | g_us | |
minusKeywords | Список минус-слов при поиске | array | да | [ ] пустой массив | ["app", "apple"] |
filters | Условия фильтрации | array | да |
"cost": "10"; "region_queries_count": "1000"; keyword_length : num "difficulty": 3; "concurrency": "7"; "right_spelling": true, "right_spelling": false "misspelled": true, "misspelled": false |
|
sort |
Порядок сортировки результатов в формате: |
array | да | ['cost' => 'asc', 'region_queries_count' => 'desc'] |
{"keyword": "desc"} или ['cost' => 'asc', 'region_queries_count' => 'desc'] |
page | Номер страницы в ответе | int | да | 1 | "page": "5" |
size | Количество результатов на страницу в ответе | int | да | 100 | "size": "10" min: 1, max: 1000 |
Для фильтрации результатов используйте следующие параметры:
Параметр | Описание | Возможные значения |
cost_from | Минимальная стоимость за клик | 0-200 |
cost_to | Максимальная стоимость за клик | 0-200 |
concurrency_from | Минимальное значение конкуренции ключевой фразы в PPC | 0-100 |
concurrency_to | Максимальное значение конкуренции ключевой фразы в PPC | 0-100 |
minus_keywords | Фильтрация по минус-словам (список слов через запятую) | string |
Параметры ответа | |
Параметр | Описание |
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 строк |
Лимиты: количество списанных лимитов соответствует количеству полученных ключевых фраз в ответе. За один запрос можно получить не более 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
},
{
"id": "1",
"method": "SerpstatKeywordProcedure.getKeywords",
"params": {
"keyword": "iphone",
"se": "g_us",
"minusKeywords": ["app", "apple"],
"sort": {"region_queries_count": "desc"},
"page": "1",
"size": "10"
}
}
{
"keyword": "iphone 13",
"cost": 1.8600000000000001,
"concurrency": 100,
"found_results": 3420000000,
"region_queries_count": 3350000,
"region_queries_count_wide": 0,
"types": [
"also_asks",
"top_stories"
],
"geo_names": [],
"social_domains": [
"wikipedia",
"twitter",
"amazon"
],
"right_spelling": null,
"lang": null,
"keyword_length": 2,
"difficulty": 46.481060722595139,
"also_asks": [
"what will be the cost of iphone 13",
"will there be an iphone 13 mini",
"is there an iphone 13 coming out"
]
},
}