Пiдбiр ключових фраз
Метод 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 |
Порядок сортування результатів в форматі: {{{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 |
Для фільтрації результатів використовуйте наступні параметри:
Параметр | Опис | Можливі значення |
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
},
{
"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"
]
},
}