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

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

Отримання списку топ-20 доменів за фразами проекту (getTopCompetitorsDomainsHistory)

Метод getTopCompetitorsDomainsHistory повертає список доменів, що потрапили у топ-20 пошукової видачi у регіонi мінімум за двома фразами проекту.

Параметри запиту
Параметр Значення Опис
id any number or string Ідентифікатор запиту
method RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory Назва методу API
params {...} Масив з параметрами
projectId number
Ідентифiкатор проекту
projectRegionId number
Ідентифікатор регіону
page number
Номер сторінки. За замовчуванням: 1
pageSize (необов'язково) number (20,50,100,200,500) Кількість результатів на сторінці. За замовчуванням: 100
dateFrom (необов'язково) date (yyyy-mm-dd)
Дата початку періоду, за який необхідно отримати дані. За замовчуванням: 30 днів від останнього зняття позицій.
dateTo (необов'язково) date (yyyy-mm-dd)
Дата кінця періоду, за який необхідно отримати данi. За замовчуванням: дата останнього зняття позицій.
sort (необов'язково) string (sum_traffic  розподіл трафіку,
keywords_count  кількість ключових фраз,
avg_position  середня позиція,
position_ranges  діапазони розподілу позицій,
ads_count  кількість платних обяв)
Параметр, за яким буде проходити сортування. За замовчуванням: за розподілом трафіку. 
sortRange (необов'язково) string 

(top1\top2...  розподіл по  позиціях

keywords_count_bottom\keywords_count_top\  розподіл по рекламних блоках

avg_position_top\avg_position_bottom\  середня позиція у рекламному блоці)

Використовується при сортуванні за параметром position_ranges.


order (необов'язково) string  (desc | asc) Напрям сортування. За замовчуванням: за зменшенням.
domains (необов'язково) array:[“string”] Домен, для якого потрібно отримати дані. За замовчуванням: всі домени, що потрапили у топ-20 хоча б по 2 фразах проекту.

Параметри відповіді
Параметр Опис
id Ідентифікатор запиту
result Інкапсулює в собі відповідь
projectId Ідентифікатор проекту
projectRegionId Ідентифікатор регіону
competitors Масив з доменами
domain Домен, що потрапив у топ-20 хоча б за двома фразами проекту
dates Масив дат з даними за вказаним доменом
date Дата, за якою виводяться дані по домену
value Значення параметру
traffic_distribution Розподіл трафіку домену серед усіх доменів топ-20 пошукової видачі
avg_position Середня позиція домена серед кращих позицій по ключових фразах проєкту
keywords_count Кількість ключових фраз, по яких домен потрапив у видачу
keywords_by_ranges Розподіл ключових фраз за діапазонами позицій домена
top1 Ключові фрази, за якими домен зайняв 1 позицию
top3 Ключові фрази, за якими домен зайняв 2-3 позиції
top5 Ключові фрази, за якими домен зайняв 4-5 позиції
top10 Ключові фрази, за якими домен зайняв 6-10 позиції
top20 Ключові фрази, за якими домен зайняв 11-20 позиції
top101 Ключові фрази, за якими домен зайняв 21-100 позиції в Google, та 21-50 в Yandex
Регіони з контекстом 
ads_count Кількість оголошень з доменом які були виявленi в контексті
keywords_count_blocks Розподіл ключових фраз у блоках контексту
avg_position_blocks Середня позиція у блоках контексту
top Верхній блок реклами
sidebar Бічний блок реклами
bottom Нижній блок реклами
summary info Блок зведеної інформації
page Поточна сторінка
page_total Кількість сторінок з результатами при обраному параметрі page size
count Кількість результатів на сторінку
total Загальна кількість результатів
sort  Сортування за параметрами
order  Напрям сортування

Example PHP Python
Request data:
{
    "id": "1",
    "method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
   "params": {
        "projectId": 651696,
        "projectRegionId": 249084,
        "page": 1,
        "pageSize": 20,
        "dateFrom": "2020-08-27",
        "dateTo": "2020-08-28",
        "sort": "domain",
        "order": "asc",
        "domains": [
            "fursk.ru",
            "ozon.ru"
        ]
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": {
            "projectId": 651696,
            "projectRegionId": 249084,
            "competitors": [
                {
                    "domain": "fursk.ru",
                    "dates": {
                        "1": {
                            "date": "2020-08-28",
                            "result": {
                                "traffic_distribution": {
                                    "value": 2.52
                                },
                                "avg_position": {
                                    "value": 31.5
                                },
                                "keywords_count": {
                                    "value": 6015
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 50
                                    },
                                    "top3": {
                                        "value": 206
                                    },
                                    "top5": {
                                        "value": 258
                                    },
                                    "top10": {
                                        "value": 752
                                    },
                                    "top20": {
                                        "value": 1400
                                    },
                                    "top101": {
                                        "value": 3349
                                    }
                                }
                            }
                        }
                    }
                },
                {
                    "domain": "ozon.ru",
                    "dates": {
                        "1": {
                            "date": "2020-08-28",
                            "result": {
                                "traffic_distribution": {
                                    "value": 2.0299999999999998
                                },
                                "avg_position": {
                                    "value": 31.600000000000001
                                },
                                "keywords_count": {
                                    "value": 4333
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 66
                                    },
                                    "top3": {
                                        "value": 151
                                    },
                                    "top5": {
                                        "value": 146
                                    },
                                    "top10": {
                                        "value": 414
                                    },
                                    "top20": {
                                        "value": 1168
                                    },
                                    "top101": {
                                        "value": 2388
                                    }
                                }
                            }
                        }
                    }
                }
            ]
        },
        "summary_info": {
            "page": 1,
            "page_total": 1,
            "count": 20,
            "total": 2,
            "sort": "domain",
            "order": "asc"
        },
        "spent_limits": 0
    }
}

Поділіться статтею з вашими друзями

Вхід Реєстрація

Ви вичерпали ліміт запитів.

Або email
Забыли пароль?
Або email
Optional
Повернутися до авторизації

Не хвилюйтеся! Лише заповніть поле з вашою email адресою і ми вишлемо вам листа для відновлення паролю.

Ви впевнені?

Awesome!

To complete your registration you need to enter your phone number

Назад

Ми надіслали код підтвердження на ваш номер телефону

Your phone Resend code Залишилося запитів

Щось пішло не так.

Зв'яжіться з нашою службою підтримки
Або підтвердіть регістарціі за допомогою Телеграм бота Перейдіть за цим посиланням
Виберіть проєкт, по якому хочете отримувати дані

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

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

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Покращити план

Експорт недоступний для вашого тарифного плану. Вам необхідно поліпшити свій тариф до Lite або вище, щоб отримати доступ до інструменту. Детальніше

Sign Up Free

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Запрошення
Просмотр Редактирование

E-mail
Повідомлення
Необов'язково
E-mail
Повідомлення
Необов'язково

У вас закінчилися ліміти

Ви досягли ліміту на кількість створених проєктів і більше не можете створювати нові проєкти. Збільште ліміти або видаліть існуючі проєкти.

Я хочу більше лімітів
Відкрити чат технічної підтримки