---
title: "Engagement rate over time"
method: GET
path: "/api/v1/analytics/engagement-over-time"
tags: ["Analytics"]
---

# Engagement rate over time

`GET /api/v1/analytics/engagement-over-time`

## Request

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

Per-day engagement rate for the period. Requires a paid tier.

## Query parameters

- `channel` string
- `period` '7d' | '30d' | '90d' | 'all'

## Response `200`

Engagement-rate time series

- object
  - `success` boolean
  - `data` object
    - `series` EngagementPoint[]
      - `date` string
      - `engagementRate` number, nullable
      - `numerator` integer
      - `denominator` integer, 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)