Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

Домены-конкуренты 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
        }
    }
}