Список конкурентов по ключевой фразе в PPC V4 (SerpstatKeywordProcedure.getAdsCompetitors)

SerpstatKeywordProcedure.getAdsCompetitors — метод выполняет поиск доменов-конкурентов в РРС по ключевой фразе.

Параметры запроса
Параметр	Описание	Тип	Опциональный	Значение по умолчанию	Варианты значений
query	Фраза, для которой будет происходить поиск	string	нет		купить ноутбук
se	Идентификатор поисковой базы, по которой будет проходить поиск	string	нет		g_ua
page	Номер страницы в ответе	int	да	1	5
pageSize	Количество результатов на страницу в ответе	int	да	100	50-1000
sort	desc — по убыванию; asc — по возрастанию	json object	да		{"common": "desc"}

Параметры ответа
Параметр	Описание
domain	Домен-конкурент
ads	Количество объявлений для домена
all	Количество ключевых фраз для домена в РРС
common	Общие ключевые фразы в РРС
summary_info	Блок сводной информации
page	Текущая страница
left_lines	Количество оставшихся API строк

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

{
"domain": "evronot.com.ua",
"ads": 113,
"all": 129,
"common": 72
}

Example PHP Python

Request data:

{
    "id": 1,
    "method": "SerpstatKeywordProcedure.getAdsCompetitors",
    "params": {
        "query": "купить ноутбук",
        "se": "g_ua",
        "page": 1,
        "pageSize": 100,
        "sort": {
            "common": "desc"
        }
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "evronot.com.ua",
                "ads": 113,
                "all": 129,
                "common": 72
            },
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 996339
        }
    }
}