Публикации

Получение данных о публикации · 1 кредит

💳 Стоимость: 1 кредит

Возвращает полную информацию о публикации по её идентификатору. Опционально можно включить список найденных репостов этой публикации.

get/v1/posts/{post_id}

Request

  • Base URL: https://maxstat.ru/api
  • URL: https://maxstat.ru/api/v1/posts/{post_id}
  • Auth: API key in header X-API-Token

Path parameters

post_idstring required

Числовой идентификатор публикации, передаётся строкой.

Example:192837465192837465

Query parameters

include_forwardsboolean

Если true, в ответ будет добавлен список репостов публикации.

Response

Successful Response

idstring required

Внутренний идентификатор публикации.

channel_idstring required

Идентификатор канала, в котором опубликован пост.

type'text' | 'file' | 'photo' | 'video' | 'audio' | 'share' | 'sticker' | 'contact' | 'location' | 'inline_keyboard' required

Тип публикации.

urlstring required

Публичная ссылка на публикацию.

textstring required

Текст публикации. Может быть пустой строкой, если пост состоит только из вложений.

text_linksobject[]

Ссылки в тексте: позиции start и length указаны в кодовых единицах UTF-16.

viewsinteger required

Текущее количество просмотров публикации.

likesinteger required

Текущее количество лайков публикации.

likes_detailedobject

Разбивка лайков по типам реакций, если такие данные доступны.

forwarded_from_idstring nullable

Идентификатор исходной публикации, если текущий пост является репостом.

forward_typestring nullable

Тип репоста или пересылки, если применимо.

published_atstring date-time required

Дата и время публикации поста.

updated_atstring date-time required

Дата и время последнего обновления данных о посте.

is_deletedboolean

Признак того, что публикация удалена из канала. Метрики при этом сохраняются.

deleted_atstring date-time nullable

Дата и время, когда удаление публикации было замечено. Пусто, если пост на месте.

Example response

{
  "id": "192837465192837465",
  "channel_id": "-91827364546372",
  "type": "text",
  "url": "https://max.ru/channel/example/post/123456",
  "text": "Запуск нового продукта состоится уже в апреле.",
  "views": 15420,
  "likes": 842,
  "likes_detailed": {
    "❤️": 14,
    "👍": 800,
    "🔥": 28
  },
  "attachments": [
    {
      "attachment_type": "image",
      "attachment_url": "https://cdn.example.com/posts/123/image.jpg"
    }
  ],
  "forwarded_from_id": "192837465192837465",
  "forward_type": "reply",
  "published_at": "2026-03-20T14:30:00+07:00",
  "updated_at": "2026-03-21T09:15:00+07:00",
  "deleted_at": "2026-03-22T18:05:00+07:00",
  "forwards": [
    {
      "id": "192837465192837465",
      "url": "https://max.ru/channel/example/post/192837465192837465",
      "published_at": "2026-03-21T10:00:00+07:00",
      "channel_id": "-91827364546372"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.