# Получение кол-ва просмотров в динамике

Описание

Метод позволяет получить суммарное количество просмотров за сутки на канале, в динамике по дням, неделям, месяцам.

Метод доступен в "API Stat" (на тарифах S и выше)

# Запрос


# URL запроса

GET

https://api.tgstat.ru/channels/views

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
channelId Идентификатор канала (@username, t.me/username, t.me/joinchat/AAAAABbbbbcccc... или ID канала в TGStat) Не задан Да
startDate Дата с (timestamp) Не задан Нет
endDate Дата по (timestamp) Не задан Нет
group Группировка результатов (day, week, month) day Нет

Для группировки group=day будет возвращено суммарное количество просмотров за сутки по состоянию на конец суток.

Для группировок group=week и group=month будет возвращено суммарное количество просмотров за период по состоянию на конец последних суток периода (недели или месяца).

Важно

Суммарное количество просмотров образуется суммированием дельт просмотров на всех публикациях канала, просмотренных в этот день, а не только из публикаций, опубликованных в этот день

# Ответ


# Структура

{ 
    "status": "ok",
    "response": {
        "items": [      # Массив данных по дням, неделям или месяцам 
            ...
        ]
    }
}

# Пример ответа

{
    "status": "ok",
    "response": {
        "items": [
            {
                "period": "2018-11-04",             # 4 ноября 2018
                "views_count": 3985                 # суммарное кол-во просмотров, совершенных 4 ноября 2018 до 23:59
            },
            {
                "period": "2018-11-03",
                "views_count": 4010
            },
            {
                "period": "2018-11-02",
                "views_count": 2381
            },
            ...
        ]
    }
}

По умолчанию вернется результат за 10 последних дней. Однако, вы можете указать необходимый период с помощью параметров startDate и endDate, соблюдая при этом ограничения на вашем тарифе.

В зависимости от запрошенного типа группировки group - поле period будет принимать один из форматов:

"Y-m-d"     # для group=day 
"Y-W"       # для group=week
"Y-m"       # для group=month

Y - Порядковый номер года, 4 цифры
m - Порядковый номер месяца с ведущим нулём
d - День месяца, 2 цифры с ведущим нулём 
W - Порядковый номер недели года в соответствии со стандартом ISO-8601; недели начинаются с понедельника
 
# Подробнее о форматах даты http://php.net/manual/ru/function.date.php