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

С 01.03.2022 методы 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
minus_keywords	Фильтрация по минус словам (список слов через запятую)	string
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 (от 1 до 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
}