---
title: "Post stats"
method: GET
path: "/api/posts/stats"
tags: ["Posts"]
---

# Post stats

`GET /api/posts/stats`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/posts/stats`
- Auth: HTTP bearer

Retrieves stats snapshots for one or more posts. Returns all matching snapshots (not just the latest) so you can see trends over time, with optional filtering by profiles/networks and timespan.

## Query parameters

- `profile_group_id` string
- `post_ids` string, required
- `profiles` string
- `from` string, date-time
- `to` string, date-time

## Response `200`

Stats snapshots keyed by post id

- PostStatsResponse: Stats snapshots keyed by post id. For thread posts, stats from all posts in the thread (parent + children) are included under the parent post's ID.
  - `data` object: Keyed by post id

## Other responses

- `400`: Missing required parameters.
- `401`: Invalid, missing, or insufficient API key permissions.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)