Конкуренты по ключевым словам V4 (SerpstatKeywordProcedure.getCompetitors)
SerpstatKeywordProcedure.getCompetitors - метод возвращает конкурентов по заданной ключевой фразе.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
keyword | Фраза для которой будет происходить поиск | string | нет | купить машину | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
{"keyword": "desc"} или {"visible": "asc"} |
size | Количество результатов на страницу в ответе | int | да | 100 | "size": {{page_size}} min: 1, max: 1000 |
Сортировка результатов возможна по следующим поля:
Параметр |
visible |
keywords |
traff |
visible_dynamic |
keywords_dynamic |
traff_dynamic |
ads_dynamic |
new_keywords |
out_keywords |
rised_keywords |
down_keywords |
ad_keywords |
ads |
intersected |
relevance |
our_relevance |
Метрики ответа:
Метрики | Описание |
result | Инкапсулирует в себе ответ |
domain | Домен |
visible | Видимость сайта |
keywords | Количество найденных ключевых фраз в выбранной поисковой системе |
traff | Индекс, который показывает ориентировочный трафик на сайт (количество посетителей) |
visible_dynamic | Динамика изменения видимости по сравнению с последней датой обновления |
keywords_dynamic | Изменение количества ключевых фраз за последние 2 недели |
traff_dynamic | Изменение трафика за последние 2 недели |
ads_dynamic | Изменение количества ключевых фраз в контекстной рекламе |
new_keywords | Количество новых ключевых фраз, которые появились у домена за последние N-дней |
out_keywords | Количество ключевых фраз, которые потерял домен за последние 2 недели |
rised_keywords | Ключевые фразы, по которым выросли позиции за последние 2 недели |
down_keywords | Ключевые фразы, по которым упали позиции за последние 2 недели |
ad_keywords | Количество ключевых фраз в PPC |
ads | Инкапсулирует результаты контекстной рекламы (если она есть) |
intersected | Количество фраз у домена, которые содержат искомую фразу |
relevance | Общая релевантность домена к искомой фразе |
our_relevance | Релевантность сайта |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов.
Часть ответа API, за которую снимается 1 лимит:
{
"domain": "olx.ua",
"visible": 12460.70378,
"keywords": 37491150,
"traff": 242167110,
"visible_dynamic": -1297.75913,
"keywords_dynamic": 607995,
"traff_dynamic": -14625413,
"ads_dynamic": 3385,
"new_keywords": 629063,
"out_keywords": 21068,
"rised_keywords": 28751,
"down_keywords": 74468,
"ad_keywords": 31033,
"ads": 30730,
"intersected": 12061,
"relevance": 0.03,
"our_relevance": 61.65
}
{
"id": {{any_num_or_string}},
"method": "SerpstatKeywordProcedure.getCompetitors",
"params": {
"se": {{search_engine}},
"keyword": {{keyword}},
(optional) "sort": { {{field}}: {{"asc"|"desc"}}}, // only 1 sort field per request. This sorting will sort only data on current page!
(optional) "size": {{page_size}}
},
}
{
"id": {{your_num_or_string}},
"result": {
"data": [
{
"domain": "olx.ua",
"visible": 12460.70378,
"keywords": 37491150,
"traff": 242167110,
"visible_dynamic": -1297.75913,
"keywords_dynamic": 607995,
"traff_dynamic": -14625413,
"ads_dynamic": 3385,
"new_keywords": 629063,
"out_keywords": 21068,
"rised_keywords": 28751,
"down_keywords": 74468,
"ad_keywords": 31033,
"ads": 30730,
"intersected": 12061,
"relevance": 0.03,
"our_relevance": 61.65
},
{
"domain": "prom.ua",
"visible": 6326.24865,
"keywords": 16058461,
"traff": 133838822,
"visible_dynamic": 636.49301,
"keywords_dynamic": 548526,
"traff_dynamic": 10114591,
"ads_dynamic": 639,
"new_keywords": 545122,
"out_keywords": 0,
"rised_keywords": 49328,
"down_keywords": 16736,
"ad_keywords": 19504,
"ads": 18826,
"intersected": 10648,
"relevance": 0.07,
"our_relevance": 54.43
},
{
"domain": "rozetka.com.ua",
"visible": 4682.05335,
"keywords": 10470203,
"traff": 87262427,
"visible_dynamic": -219.21781,
"keywords_dynamic": 314411,
"traff_dynamic": -3152065,
"ads_dynamic": 1958,
"new_keywords": 324710,
"out_keywords": 10299,
"rised_keywords": 27453,
"down_keywords": 43147,
"ad_keywords": 38577,
"ads": 37768,
"intersected": 10344,
"relevance": 0.1,
"our_relevance": 52.87
}
],
"summary_info": {
"left_lines": 93258
}
}
}