# Получение списка публикаций
Описание
Метод позволяет получить публикации канала по заданным параметрам. Возвращает сообщения канала, отсортированные в обратном хронологическом порядке (последние сверху).
Метод доступен в "API Stat" (на всех тарифах)
# Запрос
# URL запроса
GET
https://api.tgstat.ru/channels/posts
# Параметры
Параметр | Описание | Значение по умолчанию | Обязательно |
---|---|---|---|
token | Ваш токен | Не задан | Да |
channelId | Идентификатор канала (@username, t.me/username, t.me/joinchat/AAAAABbbbbcccc... или ID канала в TGStat) | Не задан | Да |
limit | Количество публикаций, которое необходимо вернуть | 20 (макс. 50) | Нет |
offset | Смещение, необходимое для выборки определённого подмножества результатов | 0 (макс. 1000) | Нет |
startTime | Дата публикации с (timestamp) | Не задан | Нет |
endTime | Дата публикации по (timestamp) | Не задан | Нет |
hideForwards | Скрывать репосты из результатов поиска | 0 | Нет |
hideDeleted | Скрывать удаленные публикации | 0 | Нет |
extended | 1 - В ответе будет возвращен объект Channel с информацией о канале | 0 | Нет |
# Ответ
# Структура
{
"status": "ok",
"response": {
"count": 50, # Кол-во возвращенных записей в массиве items
"total_count": 27518, # Общее кол-во найденных по запросу публикаций
"channel": { # Объект канала (доступен при передаче параметра extended = 1)
...
}
"items": [ # Массив объектов публикаций Post
...
],
}
}
# Пример ответа
{
"status": "ok",
"response": {
"count": 50,
"total_count": 8007,
"channel": {
"id": 7377,
"link": "t.me/breakingmash",
"username": "@breakingmash",
"title": "Mash",
"about": "Помахаться и обсудить новости - @mash_chat ...",
"image100": "//static2.tgstat.com/public/images/channels/_100/a7/a76c0abe2b7b1b79e70f0073f43c3b44.jpg",
"image640": "//static2.tgstat.com/public/images/channels/_0/a7/a76c0abe2b7b1b79e70f0073f43c3b44.jpg",
"participants_count": 431868
},
"items": [
{
"id": 3598980241,
"date": 1540123429,
"views": 148382,
"link": "t.me/breakingmash/8419",
"channel_id": 7377,
"forwarded_from": null,
"is_deleted": 0,
"text": "В Твери заправщик принял лишнего и решил, ...",
"media": {
"media_type": "mediaDocument",
"mime_type": "video/mp4",
"size": 5085138
}
},
{...},
...
]
}
}