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

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

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

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

Параметри запиту
Параметр	Опис	Опціональний	Значение за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	ні		1, test
method	Назва методу API	ні		SerpstatDomainProcedure.getCompetitors
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	ні
domain	Ім'я домену	ні		nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	ні		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: 1, max: 1000
filters	Умови фільтрації	так		"visible": 35 "visible_from":30 "visible_to": 70 "traff": 1000 "traff_from": 500 "traff_to": 5000 "minus_domains": ["domain.com". "domain2.com] "exluded_competitors": ["domain.com". "domain2.com] "keywords": 1000 "keywords_from": 1000 "keywords_to": 5000 relevance : 10 relevance_from : 5 relevance_to : 10

Параметри відповіді
Параметр	Опис
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
        }
    }
}