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

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

Історія за доменом V4 (SerpstatDomainProcedure.getDomainsHistory)

Метод SerpstatDomainProcedure.getDomainsHistory повертає історію зміни видимості і кількості фраз по домену.

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

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

Параметри запиту
Параметр Опис Опціонально Значення за замовчуванням Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test
method Назва методу API ні SerpstatDomainProcedure.getDomainsHistory
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] ні
domain Ім'я домену ні nike.com
se Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157) ні g_us
sort Порядок сортування результатів в форматі: {{{Field}}: {{order}}}

field — поле, за яким потрібно виконати сортування:
* keywords
* traff
* visible
* visible_static
* new_keywords
* out_keywords
* rised_keywords
* down_keywords
* ad_keywords
* ads
* date

order — напрямок сортування (asc — за зростанням, desc — за спаданням)
так {"ads":"desc"}
page Номер сторінки у відповіді так 1 5
size Кількість результатів на сторінку у відповіді так 100 100-1000

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
domain Домен, за яким отримана інформація
keywords Кількість знайдених ключових фраз у заданій пошуковій системі
traff Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible Видимість сайту
visible_static Динаміка зміни видимості в порівнянні з останньою датою оновлення
new_keywords Кількість нових ключових фраз, які з'явилися у домену за останні N днів
out_keywords Кількість ключових фраз, які втратив домен за останні N днів
rised_keywords Ключові фрази, у яких зросли позиції за останні N днів
down_keywords Ключові фрази, у яких впали позиції за останні N днів
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень в PPC
date Дата перевірки певного елементу масиву
summary_info Об'єкт з даними відповіді
page Номер сторінки
total Кількість результатів за запитом
left_lines Кількість API-рядків, що залишилися

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

{
    "domain": "nike.com",
    "keywords": 2603734,
    "traff": 240307722,
    "visible": 212.81692,
    "visible_static": 212.81692,
    "new_keywords": 32499,
    "out_keywords": 37326,
    "rised_keywords": 40518,
    "down_keywords": 43717,
    "ad_keywords": 1197,
    "ads": 929,
    "date": "2021-04-29"
},

Example
Request data:
{
 "id": "1",
 "method": "SerpstatDomainProcedure.getDomainsHistory",
 "params": {
   "domain": "nike.com",
   "se": "g_us",
   "sort": { "date": "desc"},
   "page": 1,
   "size": 100
 }
}
Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "keywords": 2582452,
                "traff": 252739307,
                "visible": 222.57514,
                "visible_static": 222.57514,
                "new_keywords": 31381,
                "out_keywords": 62273,
                "rised_keywords": 48816,
                "down_keywords": 42013,
                "ad_keywords": 1724,
                "ads": 1250,
                "date": "2021-05-27"
            },
            {
                "domain": "nike.com",
                "keywords": 2613344,
                "traff": 255497238,
                "visible": 222.88057,
                "visible_static": 222.88057,
                "new_keywords": 40573,
                "out_keywords": 30963,
                "rised_keywords": 49642,
                "down_keywords": 43635,
                "ad_keywords": 1098,
                "ads": 840,
                "date": "2021-05-13"
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 27,
            "left_lines": 997684
        }
    }
}