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

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

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

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

Параметри запиту
Параметр	Опис	Тип даних	Обов'язковий	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	int/string	так		1, test
method	Назва методу API	string	так		SerpstatDomainProcedure. getDomainKeywords
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	array	так
domain	Ім'я домену	string	так		nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	string	так		g_us
withSubdomains	Тип відстеження: з/без урахування піддоменів	string	ні	true	true \| false
url	Посилання уточнення пошуку	string	ні		https://www.nike.com/soccer
keywords	Масив ключових фраз, для яких буде відбуватися пошук	string	ні		["shop", "nike"]
minusKeywords	Масив мінус-слів при пошуку	string	ні		["nikes", "nke"]
filters	Умови фільтрації	array	ні	без фільтрації	варіанти фільтрації перелічені в таблиці нижче
sort	Сортування за даними (за зростанням і спаданням)	array	ні	{"position": "asc", "region_queries_count":"desc"}	"region_queries_count": "asc"/"desc" (asc — напрямок сортування за зростанням, desc — за спаданням) - Частотність ключової фрази "types": "asc"/"desc" - Спецелементи "cost": "asc"/"desc" - Вартість ключової фрази "keyword_length": "asc"/"desc" - Довжина ключової фрази "concurrency": "asc"/"desc" - Конкуренція "geo_names": "asc"/"desc" - Топоніми "traff": "asc"/"desc" - Трафік "region_queries_count_wide": "asc"/"desc" - Частотність ключової фрази в широкій відповідності "dynamic": "asc"/"desc" - Динаміка ключової фрази "position": "asc"/"desc" - Позиція "found_results": "asc"/"desc" - Кількість результатів
page	Номер сторінки у відповіді	int	ні	1	"page": "5"
size	Кількість результатів на сторінку у відповіді	int	ні	100	"size": "10" min: 1, max: 1000

Параметри фільтрації
Параметр	Опис	Тип даних	Варіанти значень
cost	Вартість ключової фрази за клік (у США $; точна відповідність)	float	будь-яке числове значення
cost_from	Вартість ключової фрази за клік (у США $; точна відповідність) від	float	будь-яке числове значення
cost_to	Вартість ключової фрази за клік (у США $; точна відповідність) до	float	будь-яке числове значення
position	Позиція ключового слова	int	будь-яке ціле число в діапазоні 1-100
position_from	Позиція ключового слова від	int	будь-яке ціле число в діапазоні 1-100
position_to	Позиція ключового слова до	int	будь-яке ціле число в діапазоні 1-100
concurrency	Конкуренція (наскільки складне просування фрази у топ від 1-100)	int	будь-яке ціле число в діапазоні 1-100
concurrency_from	Конкуренція (наскільки складне просування фрази у топ від 1-100) від	int	будь-яке ціле число в діапазоні 1-100
concurrency_to	Конкуренція (наскільки складне просування фрази у топ від 1-100) до	int	будь-яке ціле число в діапазоні 1-100
keyword_length	Кількість слів у ключовій фразі	int	будь-яке числове значення
difficulty	Складність ключової фрази	float	будь-яке числове значення
difficulty_from	Складність ключової фрази від	float	будь-яке числове значення
difficulty_to	Складність ключової фрази до	float	будь-яке числове значення
traff	Трафік за ключовою фразою	int	будь-яке ціле число
region_queries_count	Частотність ключової фрази у вибраному регіоні	int	будь-яке ціле число
region_queries_count_from	Частотність ключової фрази у вибраному регіоні від	int	будь-яке ціле число
region_queries_count_to	Частотність ключової фрази у вибраному регіоні до	int	будь-яке ціле число
region_queries_count_wide	Частотність ключової фрази у широкій відповідності	int	будь-яке ціле число
region_queries_count_wide_from	Частотність ключової фрази у широкій відповідності від	int	будь-яке ціле число
region_queries_count_wide_to	Частотність ключової фрази у широкій відповідності до	int	будь-яке ціле число
url_contains	Посилання на сторінку аналізуємого домену, який ранжується по даній ключовій фразі	string	будь-яке текстове значення
right_spelling	Відображати або не відображати ключові фрази з неправильним написанням	boolean	true або false
keyword_contain	Містить усі ключові фрази (точна відповідність)	string	будь-яке текстове значення
keyword_not_contain	Не містить усі ключові фрази (точна відповідність)	string	будь-яке текстове значення
keyword_contain_one_of	Містить одну ключову фразу з (точна відповідність)	string	будь-яке текстове значення
keyword_not_contain_one_of	Не містить одну ключову фразу з (точна відповідність)	string	будь-яке текстове значення
keyword_contain_broad_match	Містить усі ключові фрази (широка відповідність)	string	будь-яке текстове значення
keyword_not_contain_broad_match	Не містить усі ключові фрази (широка відповідність)	string	будь-яке текстове значення
keyword_contain_one_of_broad_match	Містить одну ключову фразу з (широка відповідність)	string	будь-яке текстове значення
keyword_not_contain_one_of_broad_match	Не містить одну ключову фразу з (широка відповідність)	string	будь-яке текстове значення

Параметри відповіді
Параметр	Опис
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": [
            {
                "region_queries_count": 10,
                "types": [
                    "related_search",
                    "also_asks",
                    "snip_breadcrumbs",
                    "snip_info"
                ],
                "cost": 0,
                "keyword_length": 3,
                "url": "https://www.nike.com/soccer",
                "concurrency": 0,
                "geo_names": [],
                "traff": 1,
                "region_queries_count_wide": 0,
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "dynamic": null,
                "position": 1,
                "keyword": "nike futbol 2019",
                "found_results": 40700000,
                "difficulty": 45.91084858865631
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "www nike soccer",
                "keyword_length": 3,
                "url": "https://www.nike.com/soccer",
                "position": 1,
                "types": [
                    "carousel",
                    "pic",
                    "snippet_breadcrumbs"
                ],
                "found_results": 72,
                "cost": 0,
                "concurrency": 0,
                "region_queries_count": 10,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 1,
                "difficulty": 32.55082326680605,
                "dynamic": 0
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 1704,
            "left_lines": 999014
        }
    }
}

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