История по домену
Метод 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 |
Порядок сортировки результатов в формате: |
да | {"ads":"desc"} | |
page | Номер страницы в ответе | да | 1 | 5 |
size | Количество результатов на страницу в ответе | да | 100 | 100-1000 |
filters | Условия фильтра | да |
"visible": 30 "traff": 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 | Количество объявлений домена |
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"
},
{
"id": "1",
"method": "SerpstatDomainProcedure.getDomainsHistory",
"params": {
"domain": "nike.com",
"se": "g_us",
"sort": { "date": "desc"},
"page": 1,
"size": 100
}
}
{
"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
}
}
}