TGStat API Docs

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

Описание

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

Метод доступен в "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",       # Количество просмотров на момент запроса
        "sharesCount",      # Количество пересылок публикации (включая пересылки в личные сообщения)
        "commentsCount",    # Количество комментариев к публикации
        "reactionsCount",   # Количество реакций к публикации
        "forwardsCount",    # Количество репостов публикации в другие каналы
        "mentionsCount",    # Количество упоминаний публикации в других каналах по ссылке вида t.me/username/123 
        "forwards",         # Массив со списком репостов
        "mentions",         # Массив со списком упоминаний 
        "views",            # Массив с динамикой по росту количества просмотров (за первые 15 дней после публикации) 
    }
}

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

{
    "status": "ok",
    "response": {
        "viewsCount": 157210,
        "sharesCount": 723,
        "commentsCount": 1,
        "reactionsCount": 7452,
        "forwardsCount": 3,
        "mentionsCount": 0,
        "forwards": [
            {
                "postId": "26784773903",
                "postLink": "t.me/LEGION_URAL/726365",
                "postDate": 1659673815,
                "channelId": 12337001
            },
            {
                "postId": "26778706543",
                "postLink": "t.me/moyvictortsoy/983",
                "postDate": 1659645896,
                "channelId": 11015249
            },
            {
                "postId": "26776890651",
                "postLink": "t.me/p0pizdelki/453004",
                "postDate": 1659645701,
                "channelId": 4186970
            }
        ],
        "mentions": [],
        "views": [
            {
                "date": "2022-08-04",
                "viewsGrowth": "21043"
            },
            {
                "date": "2022-08-05",
                "viewsGrowth": "110890"
            },
            {
                "date": "2022-08-06",
                "viewsGrowth": "15774"
            },
            {
                "date": "2022-08-07",
                "viewsGrowth": "6734"
            },
            {
                "date": "2022-08-08",
                "viewsGrowth": 2769
            }
        ]
    }
}

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

{
    "status": "ok",
    "response": {
        "viewsCount": 157210,
        "sharesCount": 723,
        "commentsCount": 1,
        "reactionsCount": 7452,
        "forwardsCount": 3,
        "mentionsCount": 0,
        "forwards": [
            {
                "postId": "26784773903",
                "postLink": "t.me/LEGION_URAL/726365",
                "postDate": 1659673815,
                "channelId": 12337001
            },
            {
                "postId": "26778706543",
                "postLink": "t.me/moyvictortsoy/983",
                "postDate": 1659645896,
                "channelId": 11015249
            },
            {
                "postId": "26776890651",
                "postLink": "t.me/p0pizdelki/453004",
                "postDate": 1659645701,
                "channelId": 4186970
            }
        ],
        "mentions": [],
        "views": [
            {
                "date": "2022-08-05 00:41",
                "viewsGrowth": 32367
            },
            {
                "date": "2022-08-05 01:41",
                "viewsGrowth": 7566
            },
            
            ...
            
            {
                "date": "2022-08-08 07:41",
                "viewsGrowth": 313
            },
            {
                "date": "2022-08-08 08:41",
                "viewsGrowth": 384
            },
            {
                "date": "2022-08-08 09:41",
                "viewsGrowth": 250
            },
        ]
    }
}

В зависимости от запрошенного типа группировки 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

← Поиск публикаций →