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

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

Ключові фрази по URL (url_keywords)

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

Метод url_keywords повертає ключові слова в топі пошукової системи за заданим Url. Аналогічний до звіту Аналіз домену — 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 - активний
right_spelling Фільтрація по фразам з неправильним написанням

not_contains - містить фрази з неправильним написанням;

contains - не містить фрази з неправильним написанням

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

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених ключових фраз, за якими ранжується сторінка в топі пошукової системи
hits Містить в собі відповідь
domain Домен
subdomain Піддомен сайту, який відображаеться в пошуковій видачі за заданною фразою
keyword Ключова фраза, за якою ранжується задана сторінка
keyword_length Кількість слів, розділених пробілом в ключовій фразі
url URL, який відображається в пошуковій видачі за даним запитом
position Позиція сторінки за ключовою фразою в пошуковій видачі
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
found_results Кількість знаденних результатів за ключовою фразою
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 рядків, що залишилися

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

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "man nike",
    "keyword_length": 2,
    "keyword_id": "136766933",
    "keyword_crc": -686015656,
    "url": "https://www.nike.com/men",
    "position": 1,
    "types": [
        "snip_breadcrumbs"
        ],
    "found_results": 564000000,
    "cost": 0.38,
    "concurrency": 100,
    "region_queries_count": 40500,
    "region_queries_count_wide": 0,
    "url_crc": 866156381,
    "geo_names": [],
    "traff": 6071,
    "difficulty": null,
    "dynamic": 0,
    "modified_date": "2021-07-06",
    "_id": "136766933-1"
},

Example
Request data:

api.serpstat.com/v3/url_keywords?query=https://nike.com/men&token=XXX&se=g_us

Response data:
{
    "result": {
        "total": 2805,
        "hits": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "man nike",
                "keyword_length": 2,
                "keyword_id": "136766933",
                "keyword_crc": -686015656,
                "url": "https://www.nike.com/men",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 564000000,
                "cost": 0.38,
                "concurrency": 100,
                "region_queries_count": 40500,
                "region_queries_count_wide": 0,
                "url_crc": 866156381,
                "geo_names": [],
                "traff": 6071,
                "difficulty": null,
                "dynamic": 0,
                "modified_date": "2021-07-06",
                "_id": "136766933-1"
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "mens nike",
                "keyword_length": 2,
                "keyword_id": "24277413",
                "keyword_crc": 1677651061,
                "url": "https://www.nike.com/men",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 82,
                "cost": 0.38,
                "concurrency": 100,
                "region_queries_count": 40500,
                "region_queries_count_wide": 0,
                "url_crc": 866156381,
                "geo_names": [],
                "traff": 6071,
                "difficulty": 81.587239436767788,
                "dynamic": 0,
                "modified_date": "2021-07-06",
                "_id": "24277413-1"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998847
}