---
title: "Получение данных о публикации · 1 кредит"
method: GET
path: "/v1/posts/{post_id}"
tags: ["Публикации"]
---

# Получение данных о публикации · 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`

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

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

## Path parameters

- `post_id` string, required: Числовой идентификатор публикации, передаётся строкой.

## Query parameters

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

## Response `200`

Successful Response

- PostResponse
  - `id` string, required: Внутренний идентификатор публикации.
  - `channel_id` string, required: Идентификатор канала, в котором опубликован пост.
  - `type` 'text' | 'file' | 'photo' | 'video' | 'audio' | 'share' | 'sticker' | 'contact' | 'location' | 'inline_keyboard', required: Тип публикации.
  - `url` string, required: Публичная ссылка на публикацию.
  - `text` string, required: Текст публикации. Может быть пустой строкой, если пост состоит только из вложений.
  - `text_links` object[]: Ссылки в тексте: позиции start и length указаны в кодовых единицах UTF-16.
  - `views` integer, required: Текущее количество просмотров публикации.
  - `likes` integer, required: Текущее количество лайков публикации.
  - `likes_detailed` object: Разбивка лайков по типам реакций, если такие данные доступны.
  - `attachments` Attachment[]: Список вложений публикации.
    - `attachment_type` string, required: Тип вложения публикации.
    - `attachment_url` string, required: Прямая ссылка на вложение.
  - `forwarded_from_id` string, nullable: Идентификатор исходной публикации, если текущий пост является репостом.
  - `forward_type` string, nullable: Тип репоста или пересылки, если применимо.
  - `published_at` string, date-time, required: Дата и время публикации поста.
  - `updated_at` string, date-time, required: Дата и время последнего обновления данных о посте.
  - `is_deleted` boolean: Признак того, что публикация удалена из канала. Метрики при этом сохраняются.
  - `deleted_at` string, date-time, nullable: Дата и время, когда удаление публикации было замечено. Пусто, если пост на месте.
  - `forwards` ForwardItem[], nullable: Список найденных репостов публикации. Возвращается только при `include_forwards=true`.
    - `id` string, required: Идентификатор публикации-репоста.
    - `url` string, required: Публичная ссылка на публикацию-репост.
    - `published_at` string, date-time, required: Дата и время публикации репоста.
    - `channel_id` string, required: Идентификатор канала, в котором опубликован репост.

## Other responses

- `401`: Ошибка аутентификации: API-токен не передан, недействителен или отозван.
- `402`: Проблема с тарифом: нет активного периода подписки или недостаточно кредитов.
- `403`: Доступ запрещён.
- `404`: Запрошенный ресурс не найден.
- `422`: Ошибка валидации параметров запроса. Подробности — в поле details.
- `429`: Превышен лимит запросов. Повторите запрос позже.
- `500`: Внутренняя ошибка сервиса. Сообщите request_id в поддержку.
- `503`: Сервис временно перегружен. Повторите запрос через несколько секунд (см. заголовок Retry-After).

---

[API](https://skmtc.dev/maxstat/apis/maxstat-public-api.md) · [All operations](https://skmtc.dev/maxstat/apis/maxstat-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maxstat/apis/maxstat-public-api/revisions/4eff97f9a0b2?raw)