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

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

Список конкурентів за ключовою фразою в РРС V4 (SerpstatKeywordProcedure.getAdsCompetitors)

Метод 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 Ідентифікатор пошукової бази, для якої буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157). string нi g_us
page Номер сторінки у відповіді int так 1 "page": "5"
pageSize Кількість результатів на сторінку у відповіді int так 100 "pageSize": "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",
   "pageSize": "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
        }
    }
}