Ключові слова домену
Метод SerpstatDomainProcedure.getDomainKeywords повертає ключові слова в топі пошукової системи по домену. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові слова. Ви можете експортувати до 60 000 результатів, використовуючи цей метод.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | ||||
Параметр | Опис | Опціональний | Значення за замовчуванням | Варіанти значень |
id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. | ні | 1, test | |
method | Назва методу API | ні | SerpstatDomainProcedure. | |
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}}} | так | {"position": "asc", "region_queries_count":"desc"} | {"cost": "asc"} |
page | Номер сторінки у відповіді | так | 1 | "page": "5" |
size | Кількість результатів на сторінку у відповіді | так | 100 | "size": "10" |
Параметри відповіді | |
Параметр | Опис |
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
},
{
"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
}
}
}
{
"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: посилання