Історія за доменом

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

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

Параметри запиту
Параметр	Опис	Тип даних	Опціонально	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	int/string	ні		Текстове або числове значення. Наприклад: 1, test
method	Назва методу API	string	ні		SerpstatDomainProcedure.getDomainsHistory
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		ні
domain	Ім'я домену	string	ні		Текстове значення аналізуємого домену. Наприклад: nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	string	ні		g_us, g_ca доступні пошукові бази
sort	Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field — поле, за яким потрібно виконати сортування order — напрямок сортування	object	так		field: "keywords" "traff" "visible" "visible_static" "new_keywords" "out_keywords" "rised_keywords" "down_keywords" "ad_keywords" "ads" "date" order: asc — за зростанням, desc — за спаданням Наприклад: {"ads":"desc"}
page	Номер сторінки у відповіді	int	так	1	"page": 1 (будь-яке числове значення)
size	Кількість результатів на сторінку у відповіді	int	так	100	"size": 10 (будь-яке числове значення) min: 1, max: 1000
filters	Умови фільтраціі	object	так		"visible": 30 "visible_from": 10 "visible_to": 50 "traff": 1000 "traff_from": 700 "traff_to": 5000 "date_from": "2024-12-31" "date_to": "2025-05-30"
during_all_time	Період за який надається інформація у відповіді	boolean	так	false	true — отримати інформацію за весь перiод; false — отримати інформацію за рік.

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

Request data:

{
 "id": "1",
 "method": "SerpstatDomainProcedure.getDomainsHistory",
 "params": {
    "domain": "nike.com",
    "se": "g_us",
    "sort": { "date": "desc"},
    "size": 20,
    "filters": {"visible_from": 315},
    "during_all_time": true
 }
}

Response data:

{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "keywords": 3175733,
                "traff": 124030271,
                "visible": 321.01933000000002,
                "visible_static": 321.01933000000002,
                "new_keywords": 402174,
                "out_keywords": 181443,
                "rised_keywords": 201436,
                "down_keywords": 175548,
                "ad_keywords": 3902,
                "ads": 2968,
                "date": "2022-07-30"
            },
            {
                "domain": "nike.com",
                "keywords": 2864240,
                "traff": 120305851,
                "visible": 318.67892999999998,
                "visible_static": 318.67892999999998,
                "new_keywords": 17958,
                "out_keywords": 10231,
                "rised_keywords": 22929,
                "down_keywords": 15477,
                "ad_keywords": 1046,
                "ads": 934,
                "date": "2022-06-03"
            },
            {
                "domain": "nike.com",
                "keywords": 2856513,
                "traff": 117422687,
                "visible": 318.90147999999999,
                "visible_static": 318.90147999999999,
                "new_keywords": 32115,
                "out_keywords": 25209,
                "rised_keywords": 36776,
                "down_keywords": 39943,
                "ad_keywords": 921,
                "ads": 823,
                "date": "2022-05-20"
            },
            {
                "domain": "nike.com",
                "keywords": 3181128,
                "traff": 128046844,
                "visible": 316.96537999999998,
                "visible_static": 316.96537999999998,
                "new_keywords": 27433,
                "out_keywords": 11143,
                "rised_keywords": 24665,
                "down_keywords": 23018,
                "ad_keywords": 3327,
                "ads": 2964,
                "date": "2022-01-18"
            },
            {
                "domain": "nike.com",
                "keywords": 727939,
                "traff": 15070081,
                "visible": 422.66820999999999,
                "visible_static": 422.66820999999999,
                "new_keywords": 1853,
                "out_keywords": 1166,
                "rised_keywords": 2071,
                "down_keywords": 812,
                "ad_keywords": 11594,
                "ads": 3815,
                "date": "2017-03-22"
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 5,
            "left_lines": 935732
        }
    }
}

Шаблони запитів до Serpstat API: посилання