Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы 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 Список топонимов в масcиве, если топоним присутствует в ключевой фразе. Если нет — маcсив пустой.
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
}