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

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

Параметри запиту:

Метрика	Опис	Опціонально	Значение по умолчанию	Варианты значений
domain	Ім'я домену	ні	-	allo.ua
se	Ідентифікатор пошукової бази, по якій буде проходити пошук	ні	-	g_ua
sort	Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field - поле, за яким потрібно виконати сортування order - напрямок сортування (asc - за зростанням, desc - за спаданням)	так	-	{"ads":"desc"}
page	Номер сторінки у відповіді	так	1	5
size	Кількість результатів на сторінку у відповіді	так	100	100-1000

Сортування результатів можливе за такими поля:

Параметр

date

down_keywords

visible

rised_keywords

keywords

traff

visible_static

new_keywords

out_keywords

down_keywords

ad_keywords

Метрики відповіді:

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

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

{
"domain": "google.com",
"rised_keywords": 176915,
"visible": 5995.61211,
"traff": 120802965,
"keywords": 3964146,
"visible_static": 5995.61211,
"date": "2018-07-05",
"ads": 1662,
"new_keywords": 184914,
"down_keywords": 232468,
"ad_keywords": 7638,
"out_keywords": 146804
}

Example

Request data:

{
 "id": {{any_num_or_string}},
 "method": "SerpstatDomainProcedure.getDomainsHistory",
 "params": {
   "domain": {{domain}},
   "se": {{search_engine}},
   (optional) "sort": { {{field}}: {{"asc"|"desc"}}},
   (optional) "page": {{page}},
   (optional) "size": {{page_size}}
 }
}

Response data:

{
    "id": {{your_num_or_string}},
    "result": {
        "data": [
            {
                "domain": "google.com",
                "rised_keywords": 176915,
                "visible": 5995.61211,
                "traff": 120802965,
                "keywords": 3964146,
                "visible_static": 5995.61211,
                "date": "2018-07-05",
                "ads": 1662,
                "new_keywords": 184914,
                "down_keywords": 232468,
                "ad_keywords": 7638,
                "out_keywords": 146804
            },
        ],
        "summary_info": {
            "page": 1,
            "left_lines": 99268,
            "total": 3809
        }
    }
}