# Получение статистики публикации
Описание
Получение статистики публикации - кол-во просмотров на текущий момент, список репостов и упоминаний, динамика роста просмотров по часам/дням
Метод доступен в "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