Конкуренты в платной выдаче
Метод 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 |
Порядок сортировки результатов в формате: 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
}
}
}