Конкуренты в поисковой выдаче

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

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

Перечень доступных баз и стран

Параметры запроса
Параметр	Описание	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	нет		1, test
method	Название метода API	нет		SerpstatDomainProcedure.getCompetitors
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	нет
domain	Имя домена	нет		nike.com
se	Идентификатор поисковой базы, по которой будет проходить поиск (доступны базы Google и Yandex на выбор, пример: g_us, y_157).	нет		g_us
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку: * visible * keywords * traff * visible_dynamic * keywords_dynamic * traff_dynamic * ads_dynamic * new_keywords * out_keywords * rised_keywords * down_keywords * ad_keywords * ads * intersected * relevance * new_relevance * our_relevance order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"relevance":"desc"}	{"ads":"desc"}
page	Номер страницы в ответе	да	1	"page": "1"
size	Количество результатов на страницу в ответа	да	100	"size": "50" min: 1, max: 1000
filters	Условия фильтрации	да		"visible": 35 "visible_from":30 "visible_to": 70 "traff": 1000 "traff_from": 500 "traff_to": 5000 "minus_domains": ["domain.com". "domain2.com] "exluded_competitors": ["domain.com". "domain2.com] "keywords": 1000 "keywords_from": 1000 "keywords_to": 5000 relevance : 10 relevance_from : 5 relevance_to : 10

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
domain	Домен
visible	Видимость сайта
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Ориентировочный трафик по ключевому слову в зависимости от частоты ключевика и позиции
visible_dynamic	Динамика изменения видимости по сравнению с последней датой обновления
keywords_dynamic	Изменение количества ключевых фраз по сравнению с последней датой обновления
traff_dynamic	Изменение трафика по сравнению с последней датой обновления
ads_dynamic	Изменение количества ключевых фраз в контекстной рекламе по сравнению с последней датой обновления
new_keywords	Количество новых ключевых фраз, которые появились у домена по сравнению с последней датой обновления
out_keywords	Количество ключевых фраз, которые потерял домен по сравнению с последней датой обновления
rised_keywords	Ключевые фразы, по которым выросли позиции по сравнению с последней датой обновления
down_keywords	Ключевые фразы, по которым упали позиции по сравнению с последней датой обновления
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений
intersected	Количество общих фраз у домена и конкурента
not_intersected	Количество упущенных фраз у домена, которые есть конкурента
relevance	Общая релевантность домена к анализируемому домену
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. Часть ответа API, за которую снимается 1 лимит:

 {
    "domain": "thesolesupplier.co.uk",
    "visible": 1.57363,
    "keywords": 273939,
    "traff": 987621,
    "visible_dynamic": 0.21043000000000012,
    "keywords_dynamic": 2761,
    "traff_dynamic": 82601,
    "ads_dynamic": 0,
    "new_keywords": 6341,
    "out_keywords": 3580,
    "rised_keywords": 11264,
    "down_keywords": 6878,
    "ad_keywords": 0,
    "ads": 0,
    "intersected": 192486,
    "not_intersected": 81453,
    "relevance": 70.27,
    "new_relevance": 7.04,
    "our_relevance": 7.26
},

Example

Request data:

{
 "id": "1",
 "method": "SerpstatDomainProcedure.getCompetitors",
 "params": {
   "domain": "nike.com",
   "se": "g_us",
   "sort": {"relevance":"desc"},
   "page": "1",
   "size": "50"
 }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "thesolesupplier.co.uk",
                "visible": 1.57363,
                "keywords": 273939,
                "traff": 987621,
                "visible_dynamic": 0.21043000000000012,
                "keywords_dynamic": 2761,
                "traff_dynamic": 82601,
                "ads_dynamic": 0,
                "new_keywords": 6341,
                "out_keywords": 3580,
                "rised_keywords": 11264,
                "down_keywords": 6878,
                "ad_keywords": 0,
                "ads": 0,
                "intersected": 192486,
                "not_intersected": 81453,
                "relevance": 70.27,
                "new_relevance": 7.04,
                "our_relevance": 7.26
            },
            {
                "domain": "snipesusa.com",
                "visible": 7.97392,
                "keywords": 211891,
                "traff": 4062386,
                "visible_dynamic": -0.3913399999999996,
                "keywords_dynamic": 1943,
                "traff_dynamic": -93418,
                "ads_dynamic": 6,
                "new_keywords": 13579,
                "out_keywords": 11636,
                "rised_keywords": 7644,
                "down_keywords": 10531,
                "ad_keywords": 30,
                "ads": 29,
                "intersected": 144601,
                "not_intersected": 67290,
                "relevance": 68.24,
                "new_relevance": 5.32,
                "our_relevance": 5.45
            }
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 999311
        }
    }
}