Домены-конкуренты в поисковой выдаче (competitors)

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

Метод competitors возвращает список доменов-конкурентов из топ-20 поисковой выдачи. Аналогичен отчету «Конкуренты» по домену.

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

Параметры ответа
Параметр	Описание
result	Содержит в себе ответ
domain	Домен
visible	Видимость сайта
keywords	Количество найденных ключевых фраз по домену в выбранной поисковой системе
traff	Ориентировочный трафик по ключевому слову в зависимости от частоты ключевика и позиции
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз по сравнению с последней датой обновления
traff_dynamic	Изменение трафика по сравнению с последней датой обновления
ads_dynamic	Динамика изменений в объявлениях PPC
new_keywords	Количество новых ключевых фраз, которые появились у домена по сравнению с последней датой обновления
out_keywords	Количество ключевых фраз, которые потерял домен по сравнению с последней датой обновления
rised_keywords	Ключевые фразы, по которым выросли позиции по сравнению с последней датой обновления
down_keywords	Ключевые фразы, по которым упали позиции по сравнению с последней датой обновления
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений
intersected	Количество общих фраз у домена и конкурента
not_intersected	Количество упущенных фраз у домена, которые есть конкурента
relevance	Релевантность семантики конкурента к семантике анализируемого домена (0-100%)
status_msg	Ответ: «OK» или «Error», сообщает об удачном или неудачном запросе
status_code	Код ответа «200» — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

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

{
    "domain": "snipesusa.com",
    "visible": 6.7542200000000001,
    "keywords": 205235,
    "traff": 3678917,
    "visible_dynamic": -1.2196999999999996,
    "keywords_dynamic": -6195,
    "traff_dynamic": -383469,
    "ads_dynamic": 10,
    "new_keywords": 7363,
    "out_keywords": 13558,
    "rised_keywords": 5671,
    "down_keywords": 9733,
    "ad_keywords": 40,
    "ads": 38,
    "visible_mysql": 0,
    "intersected": 140871,
    "not_intersected": 64364,
    "relevance": 68.640000000000001,
    "new_relevance": 5.1799999999999997,
    "our_relevance": 5.2999999999999998
},

Example

Request data:

api.serpstat.com/v3/competitors?query=nike.com&token=XXX&se=g_us

Response data:

{
    "result": [
        {
            "domain": "snipesusa.com",
            "visible": 6.7542200000000001,
            "keywords": 205235,
            "traff": 3678917,
            "visible_dynamic": -1.2196999999999996,
            "keywords_dynamic": -6195,
            "traff_dynamic": -383469,
            "ads_dynamic": 10,
            "new_keywords": 7363,
            "out_keywords": 13558,
            "rised_keywords": 5671,
            "down_keywords": 9733,
            "ad_keywords": 40,
            "ads": 38,
            "visible_mysql": 0,
            "intersected": 140871,
            "not_intersected": 64364,
            "relevance": 68.640000000000001,
            "new_relevance": 5.1799999999999997,
            "our_relevance": 5.2999999999999998
        },
        {
            "domain": "ladyfootlocker.com",
            "visible": 1.6694500000000001,
            "keywords": 162412,
            "traff": 2855290,
            "visible_dynamic": -0.060309999999999864,
            "keywords_dynamic": -8811,
            "traff_dynamic": -59928,
            "ads_dynamic": 0,
            "new_keywords": 370,
            "out_keywords": 9181,
            "rised_keywords": 372,
            "down_keywords": 734,
            "ad_keywords": 0,
            "ads": 0,
            "visible_mysql": 0,
            "intersected": 100446,
            "not_intersected": 61966,
            "relevance": 61.850000000000001,
            "new_relevance": 3.6899999999999999,
            "our_relevance": 3.7799999999999998
        }
    ],
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998117
}