История по домену

Метод 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
filters	Условия фильтра	да		"visible": 30 "visible_from": 10 "visible_to": 50 "traff": 1000 "traff_from": 700 "traff_to": 5000

Параметры ответа
Параметр	Описание
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	Количество объявлений домена
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
        }
    }
}