Switch to english interface?

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

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

Порядок сортировки результатов в формате:
{{{field}}: {{order}}}

field — поле, по которому нужно выполнить сортировку:

order - направление сортировки ключевых слов

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 (любое числовое значение)
min: 1, max: 1000

filters Условия фильтра object да

"visible": 30
"visible_from": 10
"visible_to": 50

"traff": 1000
"traff_from": 700
"traff_to": 5000

during_all_time Период за который предоставляется история в ответе boolean да false

true — получить информацию за весь период;
false — получить информацию за год.

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

Поделитесь статьей с вашими друзьями

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

Открыть чат технической поддержки