Ключові слова домену
Метод SerpstatDomainProcedure.getDomainKeywords повертає ключові слова в топі пошукової системи по домену. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові слова. Ви можете експортувати до 60 000 результатів, використовуючи цей метод.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | |||||
Параметр | Опис | Тип даних | Обов'язковий | Значення за замовчуванням | Варіанти значень |
id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. | int/string | так | 1, test | |
method | Назва методу API | string | так | SerpstatDomainProcedure. | |
params | Об'єкт з параметрами {...}, в ньому перераховуються всі | array | так |
| |
domain | Ім'я домену | string | так | nike.com | |
se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | string | так | g_us | |
withSubdomains | Тип відстеження: з/без урахування піддоменів | string | ні | true | true | false |
withIntents | Інтент ключової фрази | boolean | ні | false | 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"} |
|
page | Номер сторінки у відповіді | | ні | 1 | "page": "5" |
size | Кількість результатів на сторінку у відповіді | | ні | 100 | "size": "10" |
Параметри фільтрації | |||
Параметр | Опис | Тип даних | Варіанти значень |
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 | будь-яке текстове значення |
intents_contain | Містить один або кілька інтентів | array | informational, navigational, commercial, transactional |
intents_not_contain | Не містить один або кілька інтентів | array | informational, navigational, commercial, transactional |
Параметри відповіді | |
Параметр | Опис |
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 | Показує, як змінилася позиція заданої ключової фрази |
intents | Інтенти аналізованої ключової фрази |
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
},
{
"id": "1",
"method": "SerpstatDomainProcedure.getDomainKeywords",
"params": {
"domain": "nike.com",
"se": "g_us",
"withSubdomains": true,
"withIntents": true,
"sort": {
"position": "asc"
},
"url": "https://www.nike.com/soccer",
"keywords": [
"shop",
"nike"
],
"minusKeywords": [
"nikes",
"nke"
],
"page": "1",
"size": "10",
"filters": {
"right_spelling": false,
"intents_contain": ["commercial"],
"intents_not_contain":["navigational"]
}
}
}
{
"id": "1",
"result": {
"data": [
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike soccer near me",
"keyword_length": 4,
"url": "https://www.nike.com/soccer",
"position": 1,
"types": [
"related_search",
"also_asks",
"local_pack",
"pic",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 46400000,
"cost": 0,
"concurrency": 74,
"region_queries_count": 40,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 5,
"difficulty": 51,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike store soccer boots",
"keyword_length": 4,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"pic",
"related_search",
"local_pack",
"also_asks",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 22400000,
"cost": 0.37,
"concurrency": 100,
"region_queries_count": 1600,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 232,
"difficulty": 3,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike soccer shoes shop",
"keyword_length": 4,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"local_pack",
"related_search",
"pic",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 25500000,
"cost": 0.32,
"concurrency": 99,
"region_queries_count": 170,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 24,
"difficulty": 53,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike football shop",
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"video",
"pic",
"related_search",
"local_pack",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 135000000,
"cost": 0.16,
"concurrency": 71,
"region_queries_count": 40,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 5,
"difficulty": 38,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike soccer cleats shop",
"keyword_length": 4,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"pic",
"local_pack",
"related_search",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 14000000,
"cost": 0.27,
"concurrency": 93,
"region_queries_count": 170,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 24,
"difficulty": 53,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "soccer shoes nike store",
"keyword_length": 4,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"related_search",
"pic",
"local_pack",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 31800000,
"cost": 0.37,
"concurrency": 100,
"region_queries_count": 8100,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 1177,
"difficulty": 36,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike football store",
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"local_pack",
"video",
"pic",
"related_search",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 114000000,
"cost": 0.16,
"concurrency": 71,
"region_queries_count": 40,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 5,
"difficulty": 20,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike soccer footwear",
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"video",
"pic",
"related_search",
"local_pack",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 89800000,
"cost": 0.24,
"concurrency": 100,
"region_queries_count": 110000,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 15997,
"difficulty": 57,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "nike soccer stuff",
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"also_asks",
"local_pack",
"related_search",
"pic",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 10600000,
"cost": 0.12000000000000001,
"concurrency": 95,
"region_queries_count": 40,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 5,
"difficulty": 11,
"dynamic": 0,
"intents": [
"commercial"
]
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "football nike store",
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"position": 2,
"types": [
"local_pack",
"pic",
"related_search",
"snip_breadcrumbs",
"snip_image_thumbnail"
],
"found_results": 267000000,
"cost": 0.16,
"concurrency": 71,
"region_queries_count": 40,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 5,
"difficulty": 29,
"dynamic": 0,
"intents": [
"commercial"
]
}
],
"summary_info": {
"page": 1,
"total": 182,
"left_lines": 499631
}
}
}
Шаблони запитів до Serpstat API: посилання