Конкуренты в поисковой выдаче
Метод 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 |
Порядок сортировки результатов в формате: order - направление сортировки (asc — по возрастанию, desc — по убыванию)
|
да |
{"relevance":"desc"} |
{"ads":"desc"} |
page |
Номер страницы в ответе |
да |
1 |
"page": "1" |
size |
Количество результатов на страницу в ответа |
да |
100 |
"size": "50" |
filters |
Условия фильтрации |
да |
|
"visible": 35 "traff": 1000 "minus_domains": ["domain.com". "domain2.com] "exluded_competitors": ["domain.com". "domain2.com] "keywords": 1000 relevance : 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
},
{
"id": "1",
"method": "SerpstatDomainProcedure.getCompetitors",
"params": {
"domain": "nike.com",
"se": "g_us",
"sort": {"relevance":"desc"},
"page": "1",
"size": "50"
}
}
{
"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
}
}
}