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

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

Домени-конкуренти в пошуковій видачі V4 (SerpstatDomainProcedure.getCompetitors)

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

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

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

Параметри запиту

Параметр

Опис

Опціональний

Значение за замовчуванням

Варіанти значень

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test
method Назва методу API ні SerpstatDomainProcedure.getCompetitors

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domain

Ім'я домену

ні

nike.com

se

Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).

ні

g_us

sort

Порядок сортування результатів в форматі: {{{Field}}: {{order}}}

field — поле, за яким потрібно виконати сортування:
* visible
* keywords
* traff
* visible_dynamic
* keywords_dynamic
* traff_dynamic
* ads_dynamic
* new_keywords
* out_keywords
* rised_keywords
* down_keywords
* ad_keywords
* ads
* intersected
* relevance
* new_relevance
* our_relevance

order — напрямок сортування (asc — за зростанням, desc — за спаданням)

так

{"relevance":"desc"}

{"ads":"desc"}

page

Номер сторінки у відповіді

так

1

"page": "1"

size

Кількість результатів на сторінку у відповіді

так

100

"size": "50"

min: 50, max: 1000

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
domain Домен
visible Видимість сайту
keywords Кількість знайдених ключових фраз в обраній пошуковій системі
traff Орієнтовний трафік за ключовим словом в залежності від частоти ключового слова та позиції
visible_dynamic Динаміка зміни видимості в порівнянні з останньою датою оновлення
keywords_dynamic Зміна кількості ключових фраз в порівнянні з останньою датою оновлення
traff_dynamic Зміна трафіку в порівнянні з останньою датою оновлення
ads_dynamic Зміна кількості ключових фраз в порівнянні з останньою датою оновлення
new_keywords Кількість нових ключових фраз, які з'явилися у домену в порівнянні з останньою датою оновлення
out_keywords Кількість ключових фраз, які втратив домен в порівнянні з останньою датою оновлення
rised_keywords Ключові фрази, за якими зросли позиції в порівнянні з останньою датою оновлення
down_keywords Ключові фрази, за якими впали позиції в порівнянні з останньою датою оновлення
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень
intersected Кількість спільних фраз у домена та конкурента
not_intersected Кількість відсутніх фраз у домена, які є у конкурента
relevance Релевантність - наскільки близька тематика порівнюваних доменів (1-100%)
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API рядків, що залишилися

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

 {
    "domain": "thesolesupplier.co.uk",
    "visible": 1.57363,
    "keywords": 273939,
    "traff": 987621,
    "visible_dynamic": 0.21043000000000012,
    "keywords_dynamic": 2761,
    "traff_dynamic": 82601,
    "ads_dynamic": 0,
    "new_keywords": 6341,
    "out_keywords": 3580,
    "rised_keywords": 11264,
    "down_keywords": 6878,
    "ad_keywords": 0,
    "ads": 0,
    "intersected": 192486,
    "not_intersected": 81453,
    "relevance": 70.27,
    "new_relevance": 7.04,
    "our_relevance": 7.26
},

Example
Request data:
{
 "id": "1",
 "method": "SerpstatDomainProcedure.getCompetitors",
 "params": {
   "domain": "nike.com",
   "se": "g_us",
   "sort": {"relevance":"desc"},
   "page": "1",
   "size": "50"
 }
}
Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "thesolesupplier.co.uk",
                "visible": 1.57363,
                "keywords": 273939,
                "traff": 987621,
                "visible_dynamic": 0.21043000000000012,
                "keywords_dynamic": 2761,
                "traff_dynamic": 82601,
                "ads_dynamic": 0,
                "new_keywords": 6341,
                "out_keywords": 3580,
                "rised_keywords": 11264,
                "down_keywords": 6878,
                "ad_keywords": 0,
                "ads": 0,
                "intersected": 192486,
                "not_intersected": 81453,
                "relevance": 70.27,
                "new_relevance": 7.04,
                "our_relevance": 7.26
            },
            {
                "domain": "snipesusa.com",
                "visible": 7.97392,
                "keywords": 211891,
                "traff": 4062386,
                "visible_dynamic": -0.3913399999999996,
                "keywords_dynamic": 1943,
                "traff_dynamic": -93418,
                "ads_dynamic": 6,
                "new_keywords": 13579,
                "out_keywords": 11636,
                "rised_keywords": 7644,
                "down_keywords": 10531,
                "ad_keywords": 30,
                "ads": 29,
                "intersected": 144601,
                "not_intersected": 67290,
                "relevance": 68.24,
                "new_relevance": 5.32,
                "our_relevance": 5.45
            }
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 999311
        }
    }
}