Ключові фрази по URL V4 (SerpstatUrlProcedure.getUrlKeywords)

SerpstatUrlProcedure.getUrlKeywords - метод повертає ключові фрази в топі пошукової системи за заданим URL.

Параметри запиту:

Назва	Опис	Тип даних	Опціональний	Значення за замовчуванням	Варіанти значень
url	URL сторінки	string	ні		https://allo.ua/
se	Ідентифікатор пошукової бази, по якій буде проходити пошук	string	ні		g_ua, g_ru, ...
filters	Умови фільтраціі	array	так		{ "cost_from": "0.1", "cost_to": "3" }
sort	"Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field - поле, по якому потрібно виконати сортування order - напрямок сортування (asc - по зростанню, desc - по спадаючій)"		так	[ ] порожній масив	"sort": {"cnt": "asc"}
page	Номер сторінки у відповіді	int	так	1	5
size	Кількість результатів на сторінку у відповіді	int	так	100	"size": {{page_size}} min: 1, max: 1000

Сортування результатів можливе за такими полями:

Параметр

region_queries_count

cost

keyword_length

concurrency

difficulty

traff

region_queries_count_wide

dynamic

position

found_results

Для фільтрації результатів використовуйте наступні параметри:

Параметр	Опис	Можливі значення
position_from	Мінімальна позиція ключового слова	1-100
position_to	Максимальна позиція ключового слова	1-100
queries_from	Мінімальна кількість запитів в місяць	0-100000000
queries_to	Максимальна кількість запитів на місяць	0-100000000
cost_from	Мінімальна вартість за клік	0-200
cost_to	Максимальна вартість за клік	0-200
concurrency_from	Мінімальне значення конкуренції	0-100
concurrency_to	Максимальне значення конкуренції	0-100

Параметри відповіді:

Параметр	Описание
result	Інкапсулює в собі відповідь
total	Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100
region_queries_count	Частотність ключової фрази в обраному регіоні
region_queries_count_wide	Частотність ключової фрази в широкій відповідності
domain	Домен
keyword	Ключова фраза
keyword_length	Кількість слів, розділених пропуском в ключовою фразою
url	URL, який відображається в пошуковій видачі по даному запиту
dynamic	Показує, як змінилася позиція заданої ключової фрази
traff	Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
position	Позиція фрази в пошуковій відачі
found_results	Кількість знайдених результатів за ключовою фразою "" keywords ""
cost	Ціна за клік, $
concurrency	Конкуренція ключової фрази в PPC (0-100)
subdomain	Піддомен сайту, який відображається в пошуковій видачі за вашим запитом
types	Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше).
geo_names	Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
date	Дата пробивки
left_lines	Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. За один запит можна отримати не більше 60000 результатів.

Частина відповіді API, за яку знімається 1 ліміт:

{
"domain": "allo.ua",
"subdomain": null,
"keyword": "алло",
"keyword_length": 1,
"url": "https://allo.ua/",
"position": 1,
"date": "2019-04-06",
"types": [
  "pic",
  "local_pack",
  "ads_top",
  "a_box_some",
  "kn_graph_card",
  "kn_graph_brand",
  "related_search",
  "snip_sitelinks",
  "snip_https",
  "snip_search_box"
],
"found_results": 13100000,
"cost": 0.00769553,
"concurrency": 61,
"region_queries_count": 550000,
"region_queries_count_wide": 0,
"geo_names": [
  
],
"traff": 550000,
"dynamic": 0,
}

Example

Request data:

{
    "id": {{your_num_or_string}},
    "method": "SerpstatUrlProcedure.getUrlKeywords",
    "params": {
        "se": {{search_engine}},
        "url": {{url}},
        (optional) "filters": [{{field_from}}: {{value}}, {{field_to}}: {{value}}],
        (optional) "sort" : [{{filed}}:{{"asc"|"desc"}}],
        (optional) "page": {{page}},
        (optional) "size": {{size}}
    }
}

Response data:

{
  "id": {{your_num_or_string}},
  "result": {
    "data": [
      {
        "domain": "allo.ua",
        "subdomain": null,
        "keyword": "алло",
        "keyword_length": 1,
        "url": "https://allo.ua/",
        "position": 1,
        "date": "2019-04-06",
        "types": [
          "pic",
          "local_pack",
          "ads_top",
          "a_box_some",
          "kn_graph_card",
          "kn_graph_brand",
          "related_search",
          "snip_sitelinks",
          "snip_https",
          "snip_search_box"
        ],
        "found_results": 13100000,
        "cost": 0.00769553,
        "concurrency": 61,
        "region_queries_count": 550000,
        "region_queries_count_wide": 0,
        "geo_names": [
          
        ],
        "traff": 550000,
        "dynamic": 0,
      },
      
    ],
    "summary_info": {
      "page": 1,
      "total": 1052843,
      "left_lines": 9999900
    }
  }
}