Деякі функції обмежені.
Вхід Реєстрація

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

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

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

Загальні параметри запиту та інструкція щодо використання 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
        }
    }
}