История по домену 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
        }
    }
}