Сумарний звiт
Метод SerpstatKeywordProcedure.getKeywordsInfo повертає дані по ключовому слову (кількість запитів, вартість за клік, рівень конкуренції та ін.). Аналогічний до звіту «Сумарний звіт» в Аналізі ключових слів.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | |||||
---|---|---|---|---|---|
Параметр | Опис | Тип даних | Опціональний | Значення за замовчуванням | Варіанти значень |
id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення | int/string | ні | 1, test | |
method | Назва методу API | string | ні | SerpstatKeywordProcedure.getKeywordsInfo | |
params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | ні | ||
keyword | Масив фраз, для яких буде відбуватися пошук | array | ні | ["iphone", "iphone 11"] максимум 1000 ключових фраз у масиві | |
se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | string | ні | g_us | |
withIntents | Інтент ключової фрази Цей параметр працює тільки для баз даних g_ua та g_us | boolean | так | false | true | false |
sort | Порядок сортування результатів в форматі: {{{Field}}: {{order}}} | array | так | [ ] порожній масив | {"cost": "desc"} |
filters | Умови фільтраціі | array | так | "right_spelling": true$ "right_spelling": false "minus_keywords": ["case", "red"] "cost": "10"; "concurrency": "7"; "found_results": "100"; "region_queries_count": "1000"; "region_queries_count_wide": "1000"; intents_contain: ["informational", "navigational", "commercial", "transactional"]; |
Параметри відповіді | |
Параметр | Опис |
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 | Мова |
difficulty | Рівень конкуренції за ключовою фразою для просування в топ-10 органічної видачі |
suggestions_count | Кількість пошукових підказок |
keywords_count | Кількість ключових фраз |
intents | Інтенти аналізованої ключової фрази |
summary_info | Об'єкт з даними відповіді |
page | Номер сторінки |
left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 1000 результатів. Частина відповіді API, за яку знімається 1 ліміт:
{
"region_queries_count": 1220000,
"region_queries_count_wide": 1000000,
"cost": 1.43,
"concurrency": 100,
"keyword": "iphone",
"found_results": 7450000000,
"types": [
"related_search",
"pic"
],
"geo_names": [],
"social_domains": [
"youtube",
"amazon",
"wikipedia",
"reddit"
],
"right_spelling": null,
"difficulty": 76,
"lang": "en",
"suggestions_count": 0,
"keywords_count": 54222
}
{
"id": "1",
"method": "SerpstatKeywordProcedure.getKeywordsInfo",
"params": {
"keywords": [
"iphone",
"iphone 11"
],
"se": "g_us",
"withIntents": true,
"sort": {"cost": "desc"},
"filters": {
"cost_to": 10,
"region_queries_count_from": 5,
"minus_keywords": ["case","red"],
"intents_contain": ["informational", "navigational"],
"intents_not_contain":["commercial"]
}
}
}
{
"id": "1",
"result": {
"data": [
{
"keyword": "iphone 11",
"cost": 0.25999899999999998,
"concurrency": 100,
"found_results": 5050000000,
"region_queries_count": 450000,
"region_queries_count_wide": 0,
"types": [
"pic",
"refine_by_brand",
"related_search",
"also_asks",
"kn_graph_card"
],
"geo_names": [],
"social_domains": [
"youtube",
"wikipedia",
"instagram",
"reddit",
"amazon"
],
"right_spelling": null,
"lang": "en",
"difficulty": 39,
"suggestions_count": 0,
"keywords_count": 86833,
"intents": [
"informational"
]
},
{
"region_queries_count": 10,
"region_queries_count_wide": 1000000,
"cost": 0,
"concurrency": 100,
"keyword": "iphone",
"found_results": 8540000000,
"types": [
"related_search",
"shopping_top",
"pic"
],
"geo_names": [],
"social_domains": [
"amazon",
"wikipedia",
"youtube",
"reddit"
],
"right_spelling": null,
"difficulty": 76,
"lang": "en",
"suggestions_count": 0,
"keywords_count": 1943228,
"intents": [
"navigational",
"transactional"
]
}
],
"summary_info": {
"page": 1,
"left_lines": 499564
}
}
}