Ключевые слова в топе поисковой системы по домену (domain_keywords)

С 31.12.2021 методы API v3 будут недоступны. Воспользуйтесь аналогичным методом API v4.

Метод domain_keywords возвращает ключевые слова в топе поисковой системы по домену. Аналогичен отчету Анализ домена — SEO-анализ — Ключевые слова. Вы можете выгрузить до 60 000 результатов, используя данный метод.

Общие параметры запроса и инструкция по использованию Serpstat API

Для пагинации используйте параметры:
page_size: количество результатов на страницу (по умолчанию — 100, максимум — 1000).
page: номер страницы (по умолчанию — 1-я страница).

Для фильтрации результатов используйте следующие параметры:

Параметр	Описание	Возможные значения
position_from	Минимальная позиция ключевого слова	1-100
position_to	Максимальная позиция ключевого слова	1-100
queries_from	Минимальное количество запросов в месяц	0-100000000
queries_to	Максимальное количество запросов в месяц	0-100000000
cost_from	Минимальная стоимость за клик	0-200
cost_to	Максимальная стоимость за клик	0-200
concurrency_from	Минимальное значение конкуренции	1-100
concurrency_to	Максимальное значение конкуренции	1-100
url	Фильтрация по url	string
keywords	Фильтрация по словам (список слов через запятую)	string
minus_keywords	Фильтрация по минус словам (список слов через запятую)	string
exact_url	Искать только точное вхождение url	1 - активен
pm_url	Искать только частичное вхождение url	1 - активен

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

Параметры ответа
Параметр	Описание
result	Содержит в себе ответ
total	Количество найденных ключевых фраз, по которым ранжируется данный домен в топе поисковой системы
hits	Массив с данными ответа
domain	Домен, который ранжируется по ключевой фразе
subdomain	Поддомен сайта, который отображается в поисковой выдаче по заданной фразе
keyword	Ключевая фраза, по которой ранжируется заданный сайт
keyword_length	Количество слов, разделенных пробелом в ключевой фразе
url	URL, который отображается в поисковой выдаче по данному запросу
position	Позиция домена по ключевой фразы в поисковой выдаче
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое)
found_results	Количество найденных результатов по ключевой фразе «keyword»
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100%)
region_queries_count	Частотность ключевой фразы в выбранном регионе
region_queries_count_wide	Частотность ключевой фразы в широком соответствии
geo_names	Список топонимов в массиве, если топоним присутствует в ключевой фразе. Если нет — массив пустой.
traff	Ориентировочный трафик по ключевому слову в зависимости от частоты ключевика и позиции
difficulty	Оценка уровня конкуренции по ключевой фразе для продвижения в топ-10 (от 1 до 100)
dynamic	Показывает, как изменилась позиция заданной ключевой фразы
status_msg	Ответ: «OK» или «Error», сообщает об удачном или неудачном запросе
status_code	Код ответа «200» — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "nikews",
    "keyword_length": 1,
    "url": "https://www.nike.com/",
    "position": 1,
    "types": [
        "also_asks",
        "snip_search_box",
        "snip_breadcrumbs"
    ],
    "found_results": 1140000,
    "cost": 0.64000000000000001,
    "concurrency": 3,
    "region_queries_count": 20400000,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 3058470,
    "difficulty": null,
    "dynamic": null,
    "_id": "4197266083-1"
},

Example

Request data:

api.serpstat.com/v3/domain_keywords?query=nike.com&token=XXX&se=g_us

Response data:

{
    "result": {
        "total": 2590109,
        "hits": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "nikews",
                "keyword_length": 1,
                "url": "https://www.nike.com/",
                "position": 1,
                "types": [
                    "also_asks",
                    "snip_search_box",
                    "snip_breadcrumbs"
                ],
                "found_results": 1140000,
                "cost": 0.64000000000000001,
                "concurrency": 3,
                "region_queries_count": 20400000,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 3058470,
                "difficulty": null,
                "dynamic": null,
                "_id": "4197266083-1"
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "zoomxs",
                "keyword_length": 1,
                "url": "https://www.nike.com/zoomx",
                "position": 1,
                "types": [
                    "also_asks",
                    "kn_graph_carousel_list",
                    "pic",
                    "snip_breadcrumbs"
                ],
                "found_results": 62900,
                "cost": 0.81999999999999995,
                "concurrency": 5,
                "region_queries_count": 13600000,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 2038980,
                "difficulty": 0,
                "dynamic": 0,
                "_id": "753548409-1"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998864
}