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

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

Конкуренти за ключовими словами V4 (SerpstatKeywordProcedure.getCompetitors)

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

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

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

Параметри запиту
Параметр Опис Тип даних Опціональний Значення за замовчуванням Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення int/string ні
method Назва методу API string ні SerpstatKeywordProcedure.getCompetitors
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] array ні
keyword Фраза, для якої буде відбуватися пошук string ні   iphone
se Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157) 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

Параметри відповіді

Параметр

Опис

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
        }
    }
}