# Получение статистики публикации

Описание

Получение статистики публикации - кол-во просмотров на текущий момент, список репостов и упоминаний, динамика роста просмотров по часам/дням

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

# Запрос


# URL запроса

GET

https://api.tgstat.ru/posts/stat

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
postId Идентификатор поста (t.me/username/123, t.me/c/1256804429/1230 или ID публикации в TGStat) Не задан Да
group Группировка результатов (hour, day) day Нет

# Ответ


# Структура

{
    "status": "ok",
    "response": {
        "viewsCount",       # Количество просмотров на момент запроса                
        "forwardsCount",    # Количество репостов публикации
        "mentionsCount",    # Количество упоминаний публикации по ссылке вида t.me/username/123 
        "forwards",         # Массив со списком репостов
        "mentions",         # Массив со списком упоминаний 
        "views",            # Массив с динамикой по росту количества просмотров (за первые 15 дней после публикации) 
    }
}

# Пример ответа с группировкой прироста просмотров по дням

{
    "status": "ok",
    "response": {
        "viewsCount": 6255,
        "forwardsCount": 1,
        "mentionsCount": 0,
        "forwards": [
            {
                "postId": "4128289212",
                "postLink": "https://t.me/telepulse/289",
                "postDate": "1542451613",
                "channelId": "194251"
            }
        ],
        "mentions": [],
        "views": [
            {
                "date": "2018-11-17",
                "viewsGrowth": 1976
            },
            {
                "date": "2018-11-18",
                "viewsGrowth": 1127
            },
            {
                "date": "2018-11-19",
                "viewsGrowth": 562
            },
            
            ...
            
            {
                "date": "2018-11-28",
                "viewsGrowth": 209
            },
            {
                "date": "2018-11-29",
                "viewsGrowth": 218
            }
        ]
    }
}

# Пример ответа с группировкой прироста просмотров по часам

{
    "status": "ok",
    "response": {
        "viewsCount": 59159,
        "forwardsCount": 8,
        "mentionsCount": 5,
        "forwards": [
            {
                "postId": "11703591316",
                "postLink": "t.me/ugolokadmina/2901",
                "postDate": "1582037436",
                "channelId": 273767
            },
            {
                "postId": "11703792908",
                "postLink": "t.me/kashchenkokrd/114",
                "postDate": "1582021844",
                "channelId": 2022876
            },
            {
                "postId": "11687614594",
                "postLink": "t.me/freedomisland34/13447",
                "postDate": "1582015783",
                "channelId": 673254
            },
            ...
        ],
        "mentions": [
            {
                "postId": "11798605961",
                "postLink": "t.me/loffe_blog/12438",
                "postDate": "1582378654",
                "channelId": 1024154
            },
            {
                "postId": "11768177870",
                "postLink": "t.me/botshares/5803",
                "postDate": "1582295902",
                "channelId": 49014
            },
            ...
        ],
        "views": [
            {
                "date": "2020-02-18 12:08",
                "viewsGrowth": 6729
            },
            {
                "date": "2020-02-18 13:08",
                "viewsGrowth": 4692
            },
            {
                "date": "2020-02-18 14:08",
                "viewsGrowth": 3062
            },
            {
                "date": "2020-02-18 15:08",
                "viewsGrowth": 2541
            },
            {
                "date": "2020-02-18 16:08",
                "viewsGrowth": 2349
            },
            ...
        ]
    }
}

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

"Y-m-d H:i"    # для group=hour
"Y-m-d"        # для group=day

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