TGStat API Docs

# Получение списка историй

Описание

Метод позволяет получить истории канала по заданным параметрам. Возвращает истории канала, отсортированные в обратном хронологическом порядке (последние сверху).

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

# Запрос

# URL запроса

GET

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

# Параметры

Параметр Описание Значение по умолчанию Обязательно
token Ваш токен Не задан Да
channelId Идентификатор канала (@username, t.me/username, t.me/joinchat/AAAAABbbbbcccc... или ID канала в TGStat) Не задан Да
limit Количество историй, которое необходимо вернуть 20 (макс. 50) Нет
offset Смещение, необходимое для выборки определённого подмножества результатов 0 (макс. 1000) Нет
startTime Дата истории с (timestamp) Не задан Нет
endTime Дата истории по (timestamp) Не задан Нет
hideExpired Скрывать истории с истекшим сроком размещения 0 Нет
extended 1 - В ответе будет возвращен объект Channel с информацией о канале 0 Нет

# Ответ

# Структура

{
    "status": "ok",
    "response": {
        "count": 8,            # Кол-во возвращенных записей в массиве items
        "total_count": 10,     # Общее кол-во найденных по запросу историй        
        "channel": {           # Объект канала (доступен при передаче параметра extended = 1)  
            ...
        }
        "items": [             # Массив объектов историй Story
            ...
        ],
    }
}

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

{
    "status": "ok",
    "response": {
        "count": 8,
        "total_count": 10,        
        "channel": {
            "id": 7377,
            "tg_id": 1036240821,
            "link": "t.me/meduzalive",
            "peer_type": "channel",
            "username": "@meduzalive",
            "active_usernames": [
                "@meduzalive"
            ],
            "title": "Медуза — LIVE",
            "about": "Главный телеграм-канал «Медузы». Для связи: @meduzalovesyou\n\nПриложение для iOS https://mdza.io/JtSJ9t50Ww4\nИ для Android https://mdza.io/IQkzDh0RHw4\n\nРассылка Signal в телеграме: @meduzasignal",
            "category": "Новости и СМИ",
            "country": "Россия",
            "language": "Русский",
            "image100": "//static10.tgstat.ru/channels/_100/ad/ad61ab143223efbc24c7d2583be69251.jpg",
            "image640": "//static1.tgstat.ru/channels/_0/ad/ad61ab143223efbc24c7d2583be69251.jpg",
            "participants_count": 1211062,
            "tgstat_restrictions": []
        },
        "items": [
            {
                "id": 2,
                "date": 1696843128,
                "views": 23483,
                "link": "t.me/meduzalive/s/18",
                "channel_id": 74,
                "is_expired": 1,
                "expire_at": 1697015928,
                "caption": "Мой первый день преподавателя)",
                "media": {
                    "file_size": 9184495,
                    "file_url": "https://static23.tgcnt.ru/stories/_0/32/321b22809d2f98d3c7d7cd08154aaeda.mp4",
                    "file_thumbnail_url": "https://static20.tgcnt.ru/stories/_720/d7/d726d7f5e89acf67d01e4a98afcd9f1e.jpg"
                }
            },
            {...},
            ...
        ]
    }
}

← Получение списка упоминаний →