---
title: "Get live post engagement snapshots"
method: POST
path: "/v1/posts/engagement"
tags: ["posts"]
---

# Get live post engagement snapshots

`POST /v1/posts/engagement`

## Request body

- object
  - `postIds` string[], required

## Response `200`

Successful response

- PostEngagementOutput
  - `posts` PostEngagement[], required
    - `id` string, uuid, required
    - `scope` 'public' | 'private', required
    - `like_count` integer, required
    - `is_liked` boolean, required
    - `comment_count` integer, required
    - `recent_replies` PostReplyPreview[], required
      - `id` string, uuid, required
      - `user` AvatarUser, required
        - `id` string, required
        - `username` string, required
        - `display_name` string, required
        - `avatar_url` string, required
        - `rank` integer, nullable, required
        - `clan_id` string, nullable, required
        - `clan` UserClan, nullable
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `image_url` string, nullable, required
          - `banner_url` string, nullable, required
          - `chat_room_id` string, nullable, required
          - `created_at` string, required
          - `updated_at` string, required
        - `account_value_tier` integer, required
        - `is_official` boolean, required
      - `content` string, nullable, required
      - `created_at` string, required
      - `like_count` integer, required
      - `is_liked` boolean, required
      - `attachments` PostAttachment[], required
        - `id` string, uuid, required
        - `type` 'image' | 'video' | 'file' | 'audio' | 'gif' | 'sticker', required
        - `url` string, nullable, required
        - `external_url` string, nullable, required
        - `filename` string, required
        - `mime_type` string, required
        - `width` integer, nullable, required
        - `height` integer, nullable, required
        - `blur_hash` string, nullable, required
        - `duration` number, nullable, required
        - `thumbnail_url` string, nullable, required
  - `unavailable` string[], required

## Other responses

- `400` — Invalid input data
- `500` — Internal server error

## Changes

- **2026-09-19** `3769859d4c92` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/legend/apis/legend-api/changes/v1/posts/engagement/post.md)

---

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