Ключевые фразы по 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}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
"sort": {"cnt": "asc"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим поля:
Параметр |
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,
}
{
"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}}
}
}
{
"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
}
}
}