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

SerpstatDomainProcedure.getCompetitors — метод возвращает список доменов-конкурентов из топ-20 поисковой выдачи Google

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

Название	Описание	Опциональный	Значение по умолчанию	Варианты значений
domain	Имя домена	нет		allo.ua
se	Идентификатор поисковой базы, по которой будет проходить поиск	нет		g_ua
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"relevance":"desc"}	{"ads":"desc"}
page	Номер страницы в ответе	да	1	5
size	Количество результатов на страницу в ответа	да	100	50-1000

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

Параметр

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

Метрики ответа:

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

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

{
"domain": "google.com",
"visible": 6292.39888,
"keywords": 514454762,
"traff": 2795219750,
"visible_dynamic": -132.55671,
"keywords_dynamic": 48860651,
"traff_dynamic": 927779,
"ads_dynamic": 554,
"new_keywords": 54740992,
"out_keywords": 5880341,
"rised_keywords": 1010039,
"down_keywords": 985120,
"ad_keywords": 62679,
"ads": 41551,
"intersected": 514454762,
"relevance": 100,
"new_relevance": 100,
"our_relevance": 100
}

Example

Request data:


{
 "id": {{any_num_or_string}},
 "method": "SerpstatDomainProcedure.getCompetitors",
 "params": {
   "domain": {{domain}},
   "se": {{search_engine}},
   (optional) "sort": { {{field}}: {{"asc"|"desc"}}}, // only 1 sort field per request. This sorting will sort only data on current page!
   (optional) "size": {{page_size}}
 }
}

Response data:


{
    "id": {{your_num_or_string}},
    "result": {
        "data": [
            {
                "domain": "google.com",
                "visible": 6292.39888,
                "keywords": 514454762,
                "traff": 2795219750,
                "visible_dynamic": -132.55671,
                "keywords_dynamic": 48860651,
                "traff_dynamic": 927779,
                "ads_dynamic": 554,
                "new_keywords": 54740992,
                "out_keywords": 5880341,
                "rised_keywords": 1010039,
                "down_keywords": 985120,
                "ad_keywords": 62679,
                "ads": 41551,
                "intersected": 514454762,
                "relevance": 100,
                "new_relevance": 100,
                "our_relevance": 100
            },
            {
                "domain": "apple.com",
                "visible": 3814.89588,
                "keywords": 32516468,
                "traff": 1563652506,
                "visible_dynamic": -10.44331,
                "keywords_dynamic": 1138855,
                "traff_dynamic": 4112875,
                "ads_dynamic": 136,
                "new_keywords": 1265228,
                "out_keywords": 126373,
                "rised_keywords": 248398,
                "down_keywords": 225489,
                "ad_keywords": 14167,
                "ads": 4334,
                "intersected": 24353338,
                "not_intersected": 8163130,
                "relevance": 74.9,
                "new_relevance": 4.66,
                "our_relevance": 4.73
            },
 
            ........................
            ........................
 
        ],
        "summary_info": {
            "left_lines": 99985
        }
    }
}