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

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

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

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

Параметри запиту
Параметр	Опис	Тип	Опціональність	Значення за замовчуванням	Варiанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	int/string	нi		1, test
method	Назва методу API	string	нi		SerpstatKeywordProcedure.getAdsCompetitors
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	array	нi
query	Фраза, для якої буде відбуватися пошук	string	нi		iphone
se	Ідентифікатор пошукової бази, для якої буде проходити пошук.	string	нi		g_us
page	Номер сторінки у відповіді	int	так	1	"page": "5"
size	Кількість результатів на сторінку у відповіді	int	так	100	"size": "100" min: 100, max: 1000
sort	Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field - поле, по якому потрібно виконати сортування: * ads * all * common order - напрямок сортування (asc — за зростанням, desc — за спаданням)	json object	так		{"common": "desc"}

Параметры відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними
domain	Домен-конкурент
ads	Кількість оголошень для домену
all	Кількість ключових фраз для домену у РРС
common	Спiльнi ключові фрази у РРС
summary_info	Об'єкт з даними відповіді
page	Номер сторінки
left_lines	Кількість API-рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді API, за яку знімається 1 ліміт:

{
    "domain": "verizon.com",
    "ads": 8953,
    "all": 30855,
    "common": 1437
},

Example

Request data:

{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getAdsCompetitors",
 "params": {
   "query": "iphone",
   "se": "g_us",
   "page": "1",
   "size": "100",
     "sort": {
            "common": "desc"
        }
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "verizon.com",
                "ads": 8953,
                "all": 30855,
                "common": 1437
            },
            {
                "domain": "apple.com",
                "ads": 4018,
                "all": 6164,
                "common": 488
            },
            {
                "domain": "t-mobile.com",
                "ads": 2623,
                "all": 3916,
                "common": 452
            }
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 997925
        }
    }
}