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

С 01.03.2022 методы API v3 будут недоступны. Воспользуйтесь аналогичным методом API v4.

Метод domain_history возвращает историю изменения видимости и количества фраз по домену.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры ответа
Параметр	Описание
result	Содержит в себе ответ
domain	Домен, по которому получена информация
keywords	Количество найденных ключевых фраз в выбранной поисковой системе
traff	Индекс, который показывает ориентировочный трафик на сайт (количество посетителей)
visible	Видимость сайта
new_keywords	Количество новых ключевых фраз, которые появились у домена за последние N дней
out_keywords	Количество ключевых фраз которые потерял домен за последние N дней
rised_keywords	Ключевые фразы у которых выросли позиции за последние N дней
down_keywords	Ключевые фразы, у которых упали позиции за последние N дней
ad_keywords	Количество ключевых фраз в PPC
ads	Количество объявлений домена
date	Дата проверки определенного элемента массива
status_msg	Ответ: «OK» или «Error», сообщает об удачном или неудачном запросе
status_code	Код ответа «200» — успешный запрос. В других случаях — превышение лимитов (количество одновременных запросов или ограничение по лимитам аккаунта)
left_lines	Количество оставшихся API строк

Часть ответа API, за которую снимается 1 лимит:

{
    "domain": "nike.com",
    "keywords": 2603734,
    "traff": 240307722,
    "visible": 212.81692000000001,
    "visible_static": 212.81692000000001,
    "visible_mysql": 0,
    "new_keywords": 32499,
    "out_keywords": 37326,
    "rised_keywords": 40518,
    "down_keywords": 43717,
    "ad_keywords": 1197,
    "ads": 929,
    "date": "2021-04-29"
},

Example

Request data:

api.serpstat.com/v3/domain_history?query=nike.com&token=XXX&se=g_us

Response data:

{
    "result": [
        {
            "domain": "nike.com",
            "keywords": 2603734,
            "traff": 240307722,
            "visible": 212.81692000000001,
            "visible_static": 212.81692000000001,
            "visible_mysql": 0,
            "new_keywords": 32499,
            "out_keywords": 37326,
            "rised_keywords": 40518,
            "down_keywords": 43717,
            "ad_keywords": 1197,
            "ads": 929,
            "date": "2021-04-29"
        },
        {
            "domain": "nike.com",
            "keywords": 2613344,
            "traff": 255497238,
            "visible": 222.88057000000001,
            "visible_static": 222.88057000000001,
            "visible_mysql": 0,
            "new_keywords": 40573,
            "out_keywords": 30963,
            "rised_keywords": 49642,
            "down_keywords": 43635,
            "ad_keywords": 1098,
            "ads": 840,
            "date": "2021-05-13"
        }
    ],
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999030
}