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

Метод SerpstatKeywordProcedure.getCompetitors повертає конкурентів за заданою ключовою фразою з топ-20 пошукової видачі. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Конкуренти.

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

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

Параметри запиту
Параметр	Опис	Тип даних	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення	int/string	ні
method	Назва методу API	string	ні		SerpstatKeywordProcedure.getCompetitors
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	array	ні
keyword	Фраза, для якої буде відбуватися пошук	string	ні		iphone
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	string	ні		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 * our_relevance order — напрямок сортування (asc — за зростанням, desc — за спаданням)	array	так	[ ] порожній масив	{"keyword": "desc"} або {"visible": "asc"}
size	Кількість результатів на сторінку у відповіді	int	так	100	"size": "10" min: 1, max: 1000
filters	Умови фільтраціі	array	так		"domain": www.apple.com "minus_domain": www.blackberry.com "visible": 30; "visible_from": 20; "visible_to": 100 "traff": 300; "traff": 500; "traff": 1000 "relevance": 5; "relevance_from": 25; "relevance_to": 30 "our_relevance": 11 "our_relevance_from": 25; "our_relevance_to": 30

Параметри відповіді
Параметр	Опис
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	Кількість фраз у домену, які містять шукану фразу
relevance	Загальна релевантність домену до шуканої фрази
summary_info	Об'єкт з даними відповіді
page	Номер сторінки
left_lines	Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 60000 результатів. Частина відповіді API, за яку знімається 1 ліміт:

{
"apple.com": {
    "domain": "apple.com",
    "visible": 3417.2564,
    "keywords": 46650466,
    "traff": 1998603882,
    "visible_dynamic": 6.359480000000076,
    "keywords_dynamic": -751,
    "traff_dynamic": 7691041,
    "ads_dynamic": -390,
    "new_keywords": 153290,
    "out_keywords": 154041,
    "rised_keywords": 453556,
    "down_keywords": 465903,
    "ad_keywords": 5422,
    "ads": 4018,
    "intersected": 829984,
    "relevance": 1.78,
    "our_relevance": 9.97
},

Example

Request data:

{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getCompetitors",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "sort": {"relevance":"desc"},
   "size": "10"
 }
}

Response data:

{
    "id": "1",
    "result": {
        "data": {
            "apple.com": {
                "domain": "apple.com",
                "visible": 3417.2564,
                "keywords": 46650466,
                "traff": 1998603882,
                "visible_dynamic": 6.359480000000076,
                "keywords_dynamic": -751,
                "traff_dynamic": 7691041,
                "ads_dynamic": -390,
                "new_keywords": 153290,
                "out_keywords": 154041,
                "rised_keywords": 453556,
                "down_keywords": 465903,
                "ad_keywords": 5422,
                "ads": 4018,
                "intersected": 829984,
                "relevance": 1.78,
                "our_relevance": 9.97
            },
            "unsplash.com": {
                "domain": "unsplash.com",
                "visible": 529.99216,
                "keywords": 3013535,
                "traff": 269523447,
                "visible_dynamic": 5.305380000000014,
                "keywords_dynamic": 46438,
                "traff_dynamic": 4015653,
                "ads_dynamic": 0,
                "new_keywords": 81673,
                "out_keywords": 35235,
                "rised_keywords": 104336,
                "down_keywords": 75106,
                "ad_keywords": 0,
                "ads": 0,
                "intersected": 18386,
                "relevance": 0.61,
                "our_relevance": 0.22
            }
        },
        "summary_info": {
            "page": 1,
            "left_lines": 998658
        }
    }
}