Конкуренти у платній видачі

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

Загальні параметри запиту та інструкція щодо використання Serpstat API

Доступні пошукові бази

Параметри запиту
Параметр	Опис	Опціональний	Значение за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	ні		1, test
method	Назва методу API	ні		SerpstatDomainProcedure.getAdsCompetitors
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	ні
domain	Имя домена	ні		nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	ні		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
        }
    }
}