П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"] — масив виключних ключових фраз
filters	Умови фільтраціі	array	так		Ціна: "cost": 10 (0-200) — Ціна за клік в $ "cost_to": 10 (0-200) — Ціна за клік до "cost_from": 1 (0-200) — Ціна за клік від Частотність: "region_queries_count": 1000 (0-100,000,000) — Частотність ключової фрази у вибраному регіоні "region_queries_count_to": 2000 (0-100,000,000) — Частотність до "region_queries_count_from": 300 (0-100,000,000) — Частотність від Кількість слів у фразі: "keyword_length": 1 (будь-яке числове значення) — Кількість слів у ключовій фразі "keyword_length_from" (будь-яке числове значення) — Кількість слів у ключовій фразі від "keyword_length_to" (будь-яке числове значення) — Кількість слів у ключовій фразі до Складність: "difficulty": 3 (0-100) — Складність ключової фрази "difficulty_from": 5 (0-100) — Складність від "difficulty_to": 10 (0-100) — Складність до Конкуренція: "concurrency": 7 (1-100) — Конкуренція "concurrency_to": 7 (1-100) — Конкуренція до "concurrency_from": 1 (1-100) — Конкуренція від Фрази з неправильним написанням: "right_spelling": true, "right_spelling": false — Фрази з неправильним написанням: Містить всі / Не містить всі Ключові слова: "keyword_contain": string — Містить все (точна відповідність) "keyword_not_contain": string — Не містить все (точна відповідність) "keyword_contain_one_of": array — Містить один з (точна відповідність) "keyword_not_contain_one_of": array — Не містить один з (точна відповідність) "keyword_contain_broad_match": array — Містить все (широка відповідність) "keyword_not_contain_broad_match": array — Не містить все (широка відповідність) "keyword_contain_one_of_broad_match": array — Містить один з (широка відповідність) "keyword_not_contain_one_of_broad_match": array — Не містить один з (широка відповідність) Мова: "lang": {uk,ru,en,bg,pl,de,es,it,fr,ro,be,hu,ka,el,other} — Вказати мову ключової фрази Фільтрація за мовою працює тільки для g_ua бази даних.
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	Мова
keyword_length	Кількість слів, розділених пробілом в ключовій фразі
difficulty	Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
summary_info	Об'єкт з даними відповіді
page	Номер сторінки
total	Кількість знайдених варіацій ключових фраз
left_lines	Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За допомогою API запитів ви можете отримати лише перші 60000 результатів, незалежно від кількості та обсягу самих запитів. Для отримання більшої кількості даних - скористайтесь опцією експорту в розділах Аналіз домену, Аналіз ключової фрази або Аналіз URL, або зверніться до куратора за персональним вивантаженням результатів. Частина відповіді 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
},

Example PHP Python

Request data:

{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getKeywords",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "minusKeywords": ["app", "apple"],
   "filters": {"lang": "en"},
   "sort": {"region_queries_count": "asc"},
   "page": 1,
   "size": 2
 }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "keyword": "lowest price of iphone 4s in india",
                "cost": 0,
                "concurrency": 0,
                "found_results": 347000,
                "region_queries_count": 1,
                "region_queries_count_wide": 0,
                "types": [],
                "geo_names": [
                    "india"
                ],
                "social_domains": [
                    "amazon",
                    " youtube",
                    " pinterest"
                ],
                "right_spelling": null,
                "lang": "en",
                "keyword_length": 7,
                "difficulty": 3.7806799607656694
            },
            {
                "keyword": "iphone 5 s in india",
                "cost": 0,
                "concurrency": 0,
                "found_results": 15000000,
                "region_queries_count": 1,
                "region_queries_count_wide": 0,
                "types": [],
                "geo_names": [
                    "india"
                ],
                "social_domains": [
                    "wikipedia",
                    " amazon",
                    " youtube"
                ],
                "right_spelling": null,
                "lang": "en",
                "keyword_length": 5,
                "difficulty": 4.167060216464227
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 6363925,
            "left_lines": 992762
        }
    }
}

Шаблони запитів до Serpstat API: посилання