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

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

Ключові слова в топі пошукової системи за доменом (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 (від 0 до 100%)
dynamic Показує, як змінилася позиція заданої ключової фрази
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість 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
}