Ключові слова домену

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

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

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

Параметри запиту
Параметр	Опис	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	ні		1, test
method	Назва методу API	ні		SerpstatDomainProcedure. getDomainKeywords
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	ні
domain	Ім'я домену	ні		nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	ні		g_us
withSubdomains	Тип відстеження: з/без урахування піддоменів	так	true	true \| false
url	Посилання уточнення пошуку	так	null	https://www.nike.com/soccer
keywords	Масив ключових фраз, для яких буде відбуватися пошук	так	[]	["shop", "nike"]
minusKeywords	Масив мінус-слів при пошуку	так	[]	["nikes", "nke"]
filters	Умови фільтрації	так		{"right_spelling": true} {"right_spelling": false} {"position_dynamic": "new"} {"position_dynamic": "rise"} {"position_dynamic": "down"}
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 Python

Request data:

{
    "id": "1",
    "method": "SerpstatDomainProcedure.getDomainKeywords",
    "params": {
        "domain": "nike.com",
        "se": "g_us",
        "withSubdomains": true,
        "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
        }
    }
}

Шаблони запитів до Serpstat API: посилання