Ключові слова для фрази V4 (SerpstatKeywordProcedure.getKeywords)
Метод 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 | Ідентифікатор пошукової бази, по якій буде проходити пошук | string | ні | g_us | |
| minusKeywords | Список мінус-слів при пошуку | array | так | [ ] порожній масив | ["app", "apple"] |
| filters | Умови фільтраціі | array | так | {"cost_from": 0.1} | |
| sort |
Порядок сортування результатів в форматі: {{{Field}}: {{order}}} |
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 |
Для фільтрації результатів використовуйте наступні параметри:
| Параметр | Опис | Можливі значення |
| queries_from | Мінімальна частотність в місяць | 0-100000000 |
| queries_to | Максимальна частотність в місяць | 0-100000000 |
| 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 (від 0 до 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
},Request data:
{
"id": "1",
"method": "SerpstatKeywordProcedure.getKeywords",
"params": {
"keyword": "iphone",
"se": "g_us",
"minusKeywords": ["app", "apple"],
"sort": {"region_queries_count": "desc"},
"filters": {"queries_from": "1000", "queries_to": "10000"},
"page": "1",
"size": "10"
}
}Response data:
{
"id": "1",
"result": {
"data": [
{
"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
},
{
"keyword": "iphone suport",
"cost": 0.67000000000000004,
"concurrency": 8,
"found_results": 62,
"region_queries_count": 9900,
"region_queries_count_wide": 0,
"types": [
"also_asks",
"related_search",
"top_stories"
],
"geo_names": [],
"social_domains": [
"reddit",
"youtube",
"twitter",
"wikipedia"
],
"right_spelling": "iphone support",
"lang": null,
"keyword_length": 2,
"difficulty": null
}
],
"summary_info": {
"page": 1,
"total": 41575,
"left_lines": 998735
}
}
}