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

# Get Post Analytics

`GET /v1/analytics/posts`

## Request

- Base URL: `https://api.linkedmash.com`
- URL: `https://api.linkedmash.com/v1/analytics/posts`
- Auth: one of:
  - OAuth 2 (client credentials, token URL `https://api.linkedmash.com/auth/oauth/token`, scopes: `analytics:read`)
  - HTTP bearer
  - API key in header `linkedmash-api-key`

Get per-post analytics over a date range. Requires a paid Premium or Lifetime plan.

GET /v1/analytics/posts returns per-post performance for recently published posts, over the window given by date_range, capped by limit. It is the breakdown behind the totals in GET /v1/analytics.

Use it to rank your own posts by engagement, to feed a weekly report, or to close the loop on a scheduling workflow — publish through /v1/posts and read the outcome back here.

## Query parameters

- `date_range` string
- `limit` integer

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object[], required
    - `id` string, required
    - `text` string, required
    - `impressions` integer, required
    - `engagements` integer, required
    - `likes` integer, required
    - `comments` integer, required

## Other responses

- `401`: Unauthorized. The Authorization header is missing or the key is not a valid LinkedMash API key. Create or rotate keys on the API page in your LinkedMash settings.
- `402`: Payment Required. Returned with code SUBSCRIPTION_REQUIRED. The content API requires a Premium or Lifetime plan; Reader and free accounts get this on every /v1/posts, /v1/queue, /v1/schedule, /v1/media and /v1/analytics call.
- `500`: Server Error. Something failed on our side. The body carries message "Failed to fetch post analytics". Retry once; if it persists the request is not the problem.

---

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