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

# Get Analytics

`GET /v1/analytics`

## Request

- Base URL: `https://api.linkedmash.com`
- URL: `https://api.linkedmash.com/v1/analytics`
- 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 aggregate account analytics over a date range. Requires a paid Premium or Lifetime plan.

GET /v1/analytics returns account-level LinkedIn performance over a date range: impressions, reactions, comments and reshares as a metrics object, plus the current follower count. date_range takes a shorthand window such as 7d, 30d or 90d.

The numbers come from LinkedIn through the connected account, so they are only as complete as what LinkedIn exposes for that profile, and they reflect the connected account's own posts rather than anything in the saved-posts library.

## Query parameters

- `date_range` string

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object, required
    - `metrics` object, required
      - `impressions` integer, required
      - `reactions` integer, required
      - `comments` integer, required
      - `reshares` integer, required
    - `followers` 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 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)