Ключові слова
Метод SerpstatUrlProcedure.getUrlKeywords повертає ключові фрази в топі пошукової системи за заданим URL. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові слова.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | |||||
Параметр |
Опис |
Тип даних |
Опціональний |
Значення за замовчуванням |
Варіанти значень |
id |
Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. |
int/string |
ні |
1, test |
|
method |
Назва методу API |
string |
ні |
SerpstatUrlProcedure.getUrlKeywords |
|
params |
Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] |
array |
ні |
|
|
url |
URL сторінки |
string |
ні |
https://www.nike.com/men |
|
se |
Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157) |
string |
ні |
g_us |
|
filters |
Умови фільтраціі |
array |
так |
|
"keyword": ["iphone", "iphone x"] "cost": "10"; "position": 1 "concurrency": "7"; "keyword_length": 1; "difficulty": 3; "traff": 3; "region_queries_count": "1000"; "region_queries_count_wide": "1000"; "url": https://serpstat.com/api/ "url_contains": https://serpstat.com/ "right_spelling": true; "right_spelling": false |
sort |
Порядок сортування результатів в форматі: |
так |
[ ] порожній масив |
"sort": {"cnt": "asc"} |
|
page |
Номер сторінки у відповіді |
int |
так |
1 |
"page": "5" |
size |
Кількість результатів на сторінку у відповіді |
int |
так |
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%) |
dynamic | Показує, як змінилася позиція заданої ключової фрази |
summary_info | Об'єкт з даними відповіді |
page | Номер сторінки |
total |
Кількість знайдених ключових фраз, за якими ранжується сторінка в топі |
left_lines |
Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. За один запит можна отримати не більше 60000 результатів. Частина відповіді API, за яку знімається 1 ліміт:
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "man nike",
"keyword_length": 2,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"snip_breadcrumbs"
],
"found_results": 656000000,
"cost": 0.38,
"concurrency": 100,
"region_queries_count": 40500,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 6071,
"difficulty": null,
"dynamic": 0
},
{
"id": "1",
"method": "SerpstatUrlProcedure.getUrlKeywords",
"params": {
"se": "g_us",
"url": "https://www.nike.com/men",
"filters": {"cost_from": 1, "cost_to": 1000},
"sort": {"position": "asc"},
"page": "1",
"size": "10"
}
}
{
"id": "1",
"result": {
"data": [
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "man nike",
"keyword_length": 2,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"snip_breadcrumbs"
],
"found_results": 656000000,
"cost": 0.38,
"concurrency": 100,
"region_queries_count": 40500,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 6071,
"difficulty": null,
"dynamic": 0
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "buy nike men shoes",
"keyword_length": 4,
"url": "https://www.nike.com/men",
"position": 1,
"types": [
"kn_graph_carousel_list",
"a_box_card",
"snip_image_thumbnail",
"snip_breadcrumbs"
],
"found_results": 91,
"cost": 1.485899,
"concurrency": 100,
"region_queries_count": 50,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 7,
"difficulty": 80.52167499013474,
"dynamic": 0
}
],
"summary_info": {
"page": 1,
"total": 61,
"left_lines": 998269
}
}
}