Домены-конкуренты PPC V4 (SerpstatDomainProcedure.getAdsCompetitors)

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

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

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

Параметры запроса
Параметр	Описание	Опциональный	Значение по умолчанию	Варианты значений
id	Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения.	нет		1, test
method	Название метода API	нет		SerpstatDomainProcedure.getAdsCompetitors
params	Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...]	нет
domain	Имя домена	нет		nike.com
se	Идентификатор поисковой базы, по которой будет проходить поиск (доступны базы Google и Yandex на выбор, пример: g_us, y_157).	нет		g_us
sort	Порядок сортировки результатов в формате: {{{field}}: {{order}}} field - поле, по которому нужно выполнить сортировку: * ads * keywords * intersected * missing_keywords order - направление сортировки (asc — по возрастанию, desc — по убыванию)	да	{"relevance":"desc"}	{"ads":"desc"}
page	Номер страницы в ответе	да	1	"page": "1"
size	Количество результатов на страницу в ответа	да	100	"size": "50" min: 50, max: 1000

Параметры ответа
Параметр	Описание
id	Идентификатор запроса: соответствует id в запросе
result	Содержит в себе ответ
data	Массив с данными ответа
domain	Домен
keywords	Количество ключевых фраз, которые использует конкурент в контекстной рекламе
ads	Количество рекламных объявлений
intersected	Количество ключевых фраз, по которым и анализируемый домен, и конкурент размещают платные объявления
missing_keywords	Количество ключей, по которым размещает объявления конкурент и которые отсутствуют у анализируемого домена
summary_info	Объект с данными ответа
page	Номер страницы
left_lines	Количество оставшихся API строк

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

{
    "domain": "finishline.com",
    "keywords": 495,
    "ads": 453,
    "intersected": 57,
    "missing_keywords": 438
},

Example

Request data:

{
    "id": "1",
    "method": "SerpstatDomainProcedure.getAdsCompetitors",
    "params": {
        "domain": "nike.com",
        "se": "g_us",
        "page": "1",
        "size": "100", 
        "sort":{"ads":"desc"}
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "finishline.com",
                "keywords": 495,
                "ads": 453,
                "intersected": 57,
                "missing_keywords": 438
            },
            {
                "domain": "jordanusd.net",
                "keywords": 169,
                "ads": 60,
                "intersected": 2,
                "missing_keywords": 167
            }
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 998969
        }
    }
}