Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

Ключові слова для фрази (keywords)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод keywords представляє всі варіаціі аналізованої ключової фрази, за якою домени ранжуються в топ-100 органічної видачі Google або топ-50 Яндекс, і надає дані за знайденими ключовими словами (кількість запитів, вартість за клік, рівень конкуренції та ін.). Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Підбір ключових фраз.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000);
page: номер сторінки (за замовчуванням 1-а сторінка).

Для фільтрації результатів можливо використовувати параметри:

Параметр Опис Можливі значення
queries_from Мінімальна кількість запитів у місяць  0-100000000
queries_to Максимальна кількість запитів у місяць  0-100000000
cost_from Минимальна вартість за клік  0-200
cost_to Максимальна вартість за клік  0-200
concurrency_from Мінімальне значення конкуренції  1-100
concurrency_to Максимальне значення конкуренції

 1-100

right_spelling Фільтрація по фразам з неправильним написанням

not_contains - містить фрази з неправильним написанням;

contains - не містить фрази з неправильним написанням

Для сортування результату можливо використовувати параметри:
sort: поле по якому потрібно виконати сортування;
order: напрямок сортування (asc — за зростанням, desc — за спаданням).

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених варіацій ключових фраз
hits Містить в собі відповідь
keyword Задана ключова фраза
cost Ціна за клік, $
concurrency Конкуренція ключової фрази в PPC (0-100%)
found_results Кількість знаденних результатів за ключовою фразою
region_queries_count Частотність ключової фрази у вибраному регіоні
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
social_domains Соціальні домени, які знаходяться в топ-10 по заданій фразі
right_spelling Рекомендація щодо виправлення ключової фрази з орфографічною помилкою
lang Мова
keyword_length Кількість слів, розділених пробілом в ключовій фразі
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "iphone 11",
    "keyword_id": "76373283",
    "cost": 0.7,
    "concurrency": 100,
    "found_results": 96,
    "region_queries_count": 2240000,
    "types": [
        "also_asks",
        "ads_top"
        ],
    "geo_names": [],
    "social_domains": [
        "wikipedia",
        "pinterest",
        "reddit",
        "amazon"
        ],
    "right_spelling": null,
    "lang": null,
    "keyword_length": 2,
    "difficulty": 30.39
},

Example
Request data:

api.serpstat.com/v3/keywords?query=iphone&token=XXX&se=g_us

Response data:
{
    "result": {
        "total": 8323766,
        "hits": [
            {
                "keyword": "iphone 11",
                "keyword_id": "76373283",
                "cost": 0.7,
                "concurrency": 100,
                "found_results": 96,
                "region_queries_count": 2240000,
                "types": [
                    "also_asks",
                    "ads_top"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "pinterest",
                    "reddit",
                    "amazon"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 2,
                "difficulty": 30.39
            },
            {
                "keyword": "iphone 1 1",
                "keyword_id": "128864865",
                "cost": 0.7,
                "concurrency": 100,
                "found_results": 81,
                "region_queries_count": 2240000,
                "types": [
                    "also_asks",
                    "shopping_top"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "amazon",
                    "reddit"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 3,
                "difficulty": 84.69767683592724
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999738
}