---
title: "Get post analytics"
method: GET
path: "/api/v1/analytics/posts"
tags: ["Analytics"]
---

# Get post analytics

`GET /api/v1/analytics/posts`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/analytics/posts`
- Auth: HTTP bearer

## Query parameters

- `account_id` integer, required
- `from` string, date
- `to` string, date
- `limit` integer
- `offset` integer

## Response `200`

Post analytics fetched successfully

- PostAnalyticsResponse
  - `account` object
    - `id` integer
    - `platform` string
    - `username` string
  - `range` object
    - `from` string, date
    - `to` string, date
  - `posts` object[]
    - `id` integer, nullable
    - `platform_media_id` string
    - `platform` string
    - `posted_at` string, date-time, nullable
    - `likes` integer
    - `comments` integer: Comments for most platforms; replies for Threads.
    - `impressions` integer: Impressions for most platforms; views for Threads.
    - `reach` integer
    - `saved` integer
    - `shares` integer
    - `reposts` integer: Native repost count, including Threads reposts.
    - `quotes` integer: Native quote-post count, including Threads quotes.
    - `plays` integer
    - `total_interactions` integer
    - `permalink` string, nullable
    - `caption_snippet` string, nullable
    - `synced_at` string, date-time
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `429`: Too many requests

---

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