Список URL-адресов, конкурирующих с указанной страницей V4 (SerpstatUrlProcedure.getUrlCompetitors)
SerpstatUrlProcedure.getUrlCompetitors — метод возвращает cписок URL-адресов, конкурирующих с заданной страницей.
Параметры запроса:
Название параметра | Описание | Тип данных | Опциональный | Значение по умолчанию | Варианты значений |
---|---|---|---|---|---|
url | URL страницы для поиска конкурирующих url-адресов | string | нет | http://allo.ua/ | |
se | Идентификатор поисковой базы, по которой будет проходить поиск | string | нет | g_ua, g_ru, ... | |
sort |
Порядок сортировки результатов в формате: {{{field}}: {{order}}} order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
array | да | [ ] пустой массив |
{"cnt": "asc"} |
page | Номер страницы в ответе | int | да | 1 | 5 |
size | Количество результатов на страницу в ответе | int | да | 100 |
"size": {{page_size}} |
Сортировка результатов возможна по следующим поля:
Параметр |
cnt
|
Метрики ответа:
Метрика | Описание |
result | Инкапсулирует в себе ответ |
total | Количество ключевых фраз в топ-100 |
cnt | Количество одинаковых ключевых фраз у анализируемой страницы и страниц конкурентов |
domain | Домен конкурента |
url | Страница конкурента |
left_lines | Количество оставшихся API строк |
Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов. Часть ответа API, за которую снимается 1 лимит:
{
"domain": "allo.ua",
"url": "https://allo.ua/ru/mobilnye-telefony-i-sredstva-svyazi/",
"cnt": 149
}
{
"id": {{any_num_or_string}},
"method": "SerpstatUrlProcedure.getUrlCompetitors",
"params": {
"se": {{search_engine}},
"url": {{url}},
(optional) "sort": {"cnt": {{"asc"|"desc"}}},
(optional) "page": {{page}},
(optional) "size": {{page_size}}
},
}
{
"id": {{your_num_or_string}},
"result": {
"data": [
{
"domain": "allo.ua",
"url": "https://allo.ua/ru/mobilnye-telefony-i-sredstva-svyazi/",
"cnt": 149
},
{
"domain": "allo.ua",
"url": "https://allo.ua/ru/products/mobile/",
"cnt": 92
},
{
"domain": "mo.ua",
"url": "http://mo.ua/",
"cnt": 81
},
],
"summary_info": {
"page": 1,
"total": 528,
"left_lines": 94077
}
}
}