Конкуренты по ключевым словам V4 (SerpstatKeywordProcedure.getCompetitors)

SerpstatKeywordProcedure.getCompetitors - метод возвращает конкурентов по заданной ключевой фразе.

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

Название параметра	Описание	Тип данных	Опциональный	Значение по умолчанию	Варианты значений
keyword	Фраза для которой будет происходить поиск	string	нет		купить машину
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua, g_ru, ...
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку order - направление сортировки (asc — по возрастанию, desc — по убыванию)	array	да	[ ] пустой массив	{"keyword": "desc"} или {"visible": "asc"}
size	Количество результатов на страницу в ответе	int	да	100	"size": {{page_size}} min: 1, max: 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

our_relevance

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

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

Лимиты: количество списанных лимитов соответствует количеству полученных результатов по запросу. За один запрос можно получить не более 60000 результатов.

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

{
"domain": "olx.ua",
"visible": 12460.70378,
"keywords": 37491150,
"traff": 242167110,
"visible_dynamic": -1297.75913,
"keywords_dynamic": 607995,
"traff_dynamic": -14625413,
"ads_dynamic": 3385,
"new_keywords": 629063,
"out_keywords": 21068,
"rised_keywords": 28751,
"down_keywords": 74468,
"ad_keywords": 31033,
"ads": 30730,
"intersected": 12061,
"relevance": 0.03,
"our_relevance": 61.65
}

Example

Request data:

{
 "id": {{any_num_or_string}},
 "method": "SerpstatKeywordProcedure.getCompetitors",
 "params": {
     "se": {{search_engine}},
     "keyword": {{keyword}},
     (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": "olx.ua",
                "visible": 12460.70378,
                "keywords": 37491150,
                "traff": 242167110,
                "visible_dynamic": -1297.75913,
                "keywords_dynamic": 607995,
                "traff_dynamic": -14625413,
                "ads_dynamic": 3385,
                "new_keywords": 629063,
                "out_keywords": 21068,
                "rised_keywords": 28751,
                "down_keywords": 74468,
                "ad_keywords": 31033,
                "ads": 30730,
                "intersected": 12061,
                "relevance": 0.03,
                "our_relevance": 61.65
            },
            {
                "domain": "prom.ua",
                "visible": 6326.24865,
                "keywords": 16058461,
                "traff": 133838822,
                "visible_dynamic": 636.49301,
                "keywords_dynamic": 548526,
                "traff_dynamic": 10114591,
                "ads_dynamic": 639,
                "new_keywords": 545122,
                "out_keywords": 0,
                "rised_keywords": 49328,
                "down_keywords": 16736,
                "ad_keywords": 19504,
                "ads": 18826,
                "intersected": 10648,
                "relevance": 0.07,
                "our_relevance": 54.43
            },
            {
                "domain": "rozetka.com.ua",
                "visible": 4682.05335,
                "keywords": 10470203,
                "traff": 87262427,
                "visible_dynamic": -219.21781,
                "keywords_dynamic": 314411,
                "traff_dynamic": -3152065,
                "ads_dynamic": 1958,
                "new_keywords": 324710,
                "out_keywords": 10299,
                "rised_keywords": 27453,
                "down_keywords": 43147,
                "ad_keywords": 38577,
                "ads": 37768,
                "intersected": 10344,
                "relevance": 0.1,
                "our_relevance": 52.87
            }
        ],
        "summary_info": {
            "left_lines": 93258
        }
    }
}