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

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

Пропозиції щодо пошуку ключових слів (suggestions)

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

Метод suggestions виконує повнотекстовий пошук по пошуковим підказкам аналізованого ключового слова. Використовуйте параметр question = 1, щоб отримати лише запитання. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Пошук підказок.

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

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

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених пошукових підказок
hits Містить в собі відповідь
keyword Пошукова підказка
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

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

{
    "keyword": "iphone x fre case release",
    "geo_names": [],
    "_id": "db44a9cbdacc966c4d6dc85f5f47f056"
},

Example
Request data:

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

Response data:
{
    "result": {
        "total": 2652668,
        "hits": [
            {
                "keyword": "iphone x fre case release",
                "geo_names": [],
                "_id": "db44a9cbdacc966c4d6dc85f5f47f056"
            },
            {
                "keyword": "iphone 7 plus tekniset tiedot",
                "geo_names": [],
                "_id": "3db42bb6c2392dd351af4c759638b159"
            },
            {
                "keyword": "softlogic iphone x",
                "geo_names": [],
                "_id": "7441b8fb8c10ed2dc7c886d96a59749e"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999535
}