Список URL-адресов, конкурирующих с запрашиваемой страницей (url_competitors)

31.12.2021 методы API v3 будут недоступны. Воспользуйтесь аналогичным методом API v4.

Метод url_competitors возвращает URL конкурентов для заданного URL. Аналогичен отчету «Конкуренты» в Анализе страниц.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры ответа
Параметр	Описание
result	Содержит в себе ответ
total	Количество ключевых фраз в топ-10
hits	Массив с данными ответа
cnt	Количество одинаковых ключевых фраз у анализируемой страницы и страниц конкурентов
domain	Домен конкурента
url	Страница конкурента
status_msg	Ответ: «OK» или «Error», сообщает об удачном или неудачном запросе
status_code	Код ответа «200» — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
    "cnt": 230,
    "domain": "nike.com",
    "url": "https://www.nike.com/w/mens-shoes-nik1zy7ok",
    "url_crc": -1410140829
},

Example

Request data:

api.serpstat.com/v3/url_competitors?query=https://nike.com/men&token=XXX&se=g_us

Response data:

{
    "result": {
        "total": 354,
        "hits": [
            {
                "cnt": 230,
                "domain": "nike.com",
                "url": "https://www.nike.com/w/mens-shoes-nik1zy7ok",
                "url_crc": -1410140829
            },
            {
                "cnt": 190,
                "domain": "nike.com",
                "url": "https://www.nike.com/",
                "url_crc": 855213616
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998579
}