Пiдбiр ключових фраз
Метод 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"] — масив виключних ключових фраз | |
| withIntents | Інтент ключової фрази Цей параметр працює тільки для баз даних g_ua та g_us | boolean | так | false | true | false |
| filters | Умови фільтраціі | array | так | Ціна: Частотність: Кількість слів у фразі: Складність: Конкуренція: Фрази з неправильним написанням: Ключові слова: | |
| 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 | Мова |
| intents | Інтенти аналізованої ключової фрази |
| keyword_length | Кількість слів, розділених пробілом в ключовій фразі |
| difficulty | Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%) |
| summary_info | Об'єкт з даними відповіді |
| page | Номер сторінки |
| total | Кількість знайдених варіацій ключових фраз |
| left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За допомогою API запитів ви можете отримати лише перші 60000 результатів, незалежно від кількості та обсягу самих запитів. Для отримання більшої кількості даних - скористайтесь опцією експорту в розділах Аналіз домену, Аналіз ключової фрази або Аналіз URL, або зверніться до куратора за персональним вивантаженням результатів. Частина відповіді 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"],
"withIntents": true,
"filters": {
"lang": "en",
"intents_contain": ["commercial"],
"intents_not_contain":["navigational"]
},
"sort": {"region_queries_count": "asc"},
"page": 1,
"size": 2
}
}{
"id": "1",
"result": {
"data": [
{
"region_queries_count": 0,
"region_queries_count_wide": 0,
"cost": 0,
"concurrency": 0,
"keyword": "best tws under 10000 for iphone",
"keyword_length": 6,
"found_results": 0,
"types": [],
"geo_names": [],
"social_domains": [],
"right_spelling": null,
"difficulty": null,
"lang": "en",
"intents": [
"commercial"
]
},
{
"region_queries_count": 0,
"region_queries_count_wide": 0,
"cost": 0,
"concurrency": 0,
"keyword": "samsung s9 plus and iphone x which is better",
"keyword_length": 9,
"found_results": 0,
"types": [],
"geo_names": [],
"social_domains": [],
"right_spelling": null,
"difficulty": null,
"lang": "en",
"intents": [
"commercial"
]
}
],
"summary_info": {
"page": 1,
"total": 110100,
"left_lines": 499621
}
}
}Шаблони запитів до Serpstat API: посилання