История по домену
Метод 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 | Порядок сортировки результатов в формате: | 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":5 (любое числовое значение) |
| size | Количество результатов на страницу в ответе | int | да | 100 | "size": 10 (любое числовое значение) |
| filters | Условия фильтра | object | да | "visible": 30 "traff": 1000 | |
| during_all_time | Период за который предоставляется история в ответе | boolean | да | false | true — получить информацию за весь период; |
| Параметры ответа | |
| Параметр | Описание |
| 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"
},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: ссылка