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

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

Ключові слова в топі пошукової системи по домену V4 (SerpstatDomainProcedure.getDomainKeywords)

Метод SerpstatDomainProcedure.getDomainKeywords повертає ключові слова в топі пошукової системи по домену. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові словаВи можете експортувати до 60 000 результатів, використовуючи цей метод. 

Загальні параметри запиту та інструкція щодо використання Serpstat API

Доступні пошукові бази

Параметри запиту

Параметр

Опис

Опціональний

Значення за замовчуванням

Варіанти значень

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test

method

Назва методу API

ні

SerpstatDomainProcedure.
getDomainKeywords

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domain

Ім'я домену

ні

nike.com

se

Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).

ні

g_us

url

Посилання уточнення пошуку

так

null

https://www.nike.com/soccer

keywords

Масив ключових фраз, для яких буде відбуватися пошук

так

[]

["shop", "nike"]

minusKeywords

Масив мінус-слів при пошуку

так

[]

["nikes", "nke"]

filters

Умови фільтрації

так

{"right_spelling": true}

{"right_spelling": false}

sort

Порядок сортування результатів в форматі: {{{Field}}: {{order}}}

field — поле, за яким потрібно виконати сортування:
* region_queries_count
* types
* cost
* keyword_length
* concurrency
* geo_names
* traff
* region_queries_count_wide
* dynamic
* position
* found_results

order — напрямок сортування (asc — за зростанням, desc — за спаданням)

так

{"position": "asc", "region_queries_count":"desc"}

{"cost": "asc"}

page

Номер сторінки у відповіді

так

1

"page": "5"

size

Кількість результатів на сторінку у відповіді

так

100

"size": "10"

min: 1, max: 1000

Параметри відповіді

Параметр

Опис

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data

Масив з даними

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%)

right_spelling

Рекомендація до виправлення для ключової фрази з орфографічною помилкою

dynamic

Показує, як змінилася позиція заданої ключової фрази

summary_info Об'єкт з даними відповіді
page Номер сторінки

total

Кількість знайдених результатів

left_lines

Кількість API рядків, що залишилися

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

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "nike socer",
    "keyword_length": 2,
    "url": "https://www.nike.com/soccer",
    "position": 1,
    "types": [
        "shopping_rhs",
        "ads_top",
        "snip_breadcrumbs"
    ],
    "found_results": 90,
    "cost": 0.48,
    "concurrency": 100,
    "region_queries_count": 9900,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 1484,
    "difficulty": 20.35,
    "right_spelling": "nike soccer",
    "dynamic": 0
},

Example
Request data:
{
    "id": "1",
    "method": "SerpstatDomainProcedure.getDomainKeywords",
    "params": {
        "domain": "nike.com",
        "se": "g_us",
        "sort": {
            "position": "asc"
        },
        "url": "https://www.nike.com/soccer",
        "keywords": [
            "shop",
            "nike"
        ],
        "minusKeywords": [
            "nikes",
            "nke"
        ],
        "page": "1",
        "size": "10",
        "filters": {
            "right_spelling": false
        }
    }
}
Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "nike socer",
                "keyword_length": 2,
                "url": "https://www.nike.com/soccer",
                "position": 1,
                "types": [
                    "shopping_rhs",
                    "ads_top",
                    "snip_breadcrumbs"
                ],
                "found_results": 90,
                "cost": 0.48,
                "concurrency": 100,
                "region_queries_count": 9900,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 1484,
                "difficulty": 20.35,
                "right_spelling": "nike soccer",
                "dynamic": 0
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "nike spccer",
                "keyword_length": 2,
                "url": "https://www.nike.com/soccer",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 99,
                "cost": 0.48,
                "concurrency": 100,
                "region_queries_count": 9900,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 1484,
                "difficulty": null,
                "right_spelling": "nike soccer",
                "dynamic": 0
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 77,
            "left_lines": 997219
        }
    }
}