Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

История по домену V4 (SerpstatDomainProcedure.getDomainsHistory)

Метод 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

Параметры ответа
Параметр Описание
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
        }
    }
}