Список URL-адресов, конкурирующих с указанной страницей V4 (SerpstatUrlProcedure.getUrlCompetitors)

SerpstatUrlProcedure.getUrlCompetitors — метод возвращает cписок URL-адресов, конкурирующих с заданной страницей.

Параметры запроса:

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

Сортировка результатов возможна по следующим поля:

Параметр

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
}

Example

Request data:


{
 "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}}
 },
}

Response data:


{
    "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
        }
    }
}