Ключевые фразы по 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 — по убыванию)	array	да	[ ] пустой массив	"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_length	Количество слов, разделенных пробелом в ключевой фразе
keyword	Ключевая фраза
url	URL, который отображается в поисковой выдаче по данному запросу
dynamic	Показывает, как изменилась позиция заданной ключевой фразы
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
types	Список дополнительных элементов которые отображаются в SERP (например, видео, карусель изображений, карта и другое ).
found_results	Количество найденных результатов по ключевой фразе ""keywords""
cost	Цена за клик, $
concurrency	Конкуренция ключевой фразы в PPC (0-100)
position	Позиция ключевой фразы в поисковой выдаче
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
    }
  }
}