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

# Per-post performance

`GET /api/v1/analytics/posts`

## Request

- Base URL: `https://api-app.postnext.io`
- URL: `https://api-app.postnext.io/api/v1/analytics/posts`
- Auth: API key in header `x-api-key`

## Query parameters

- `channel` string
- `period` '7d' | '30d' | '90d' | 'all'
- `sort` 'engagement' | 'impressions' | 'likes' | 'recent'

## Response `200`

Per-post metric rows

- object
  - `success` boolean
  - `data` AnalyticsPosts
    - `rows` PostPerformanceRow[]
      - `postId` string
      - `provider` string
      - `channelName` string, nullable
      - `publishedAt` string, date-time, nullable
      - `impressions` integer
      - `reach` integer
      - `likes` integer
      - `comments` integer
      - `engagementRate` number, nullable
    - `capability` 'ok' | 'insights_unavailable' | 'api_tier_limited' | 'no_data_yet' | 'unsupported'

## Other responses

- `401`: Missing or invalid API key
- `403`: Caller is not a member of the team

---

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