Конкуренты в платной выдаче
Метод SerpstatDomainProcedure.getAdsCompetitors возвращает список доменов-конкурентов в платной выдаче. Аналогичен отчету «Конкуренты» в PPC-анализе по домену.
Общие параметры запроса и инструкция по использованию Serpstat API
Перечень доступных баз и стран
| Параметры запроса | ||||
| Параметр | Описание | Опциональный | Значение по умолчанию | Варианты значений |
| id | Идентификатор запроса: ответ содержит этот же идентификатор. Ввод числового (number) или текстового (string) значения. | нет | 1, test | |
| method | Название метода API | нет | SerpstatDomainProcedure.getAdsCompetitors | |
| params | Объект с параметрами {...}, в нем перечисляются все нижеследующие параметры и массивы [...] | нет | ||
| domain | Имя домена | нет | nike.com | |
| se | Идентификатор поисковой базы, по которой будет проходить поиск. | нет | g_us | |
| sort | Порядок сортировки результатов в формате: order - направление сортировки (asc — по возрастанию, desc — по убыванию) | да | {"relevance":"desc"} | {"ads":"desc"} |
| page | Номер страницы в ответе | да | 1 | "page": "1" |
| size | Количество результатов на страницу в ответа | да | 100 | "size": "50" |
| Параметры ответа | |
| Параметр | Описание |
| 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
},{
"id": "1",
"method": "SerpstatDomainProcedure.getAdsCompetitors",
"params": {
"domain": "nike.com",
"se": "g_us",
"page": "1",
"size": "100",
"sort":{"ads":"desc"}
}
}{
"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
}
}
}