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

# Get workspace analytics overview

`GET /analytics/overview`

## Query parameters

- `period` '7d' | '30d' | '90d'
- `start_date` string
- `end_date` string

## Response `200`

Analytics overview

- object
  - `data` AnalyticsOverview
    - `total_posts` integer
    - `total_platforms` integer
    - `total_engagement` number
    - `total_impressions` number
    - `average_engagement_rate` number — Engagement rate as a percentage (0-100)
    - `top_performing_platform` string, nullable
    - `platform_breakdown` object
  - `period` string — Human-readable range label (e.g. "30d" or "2026-04-01 to 2026-04-30")
  - `start_date` string, date — Resolved range start (YYYY-MM-DD), useful for clients that want to confirm what was queried
  - `end_date` string, date — Resolved range end (YYYY-MM-DD)
  - `current_date` string, date — Server's current date (UTC), included so clients can self-correct relative phrases like "last month"

## Other responses

- `400` — Invalid date input (e.g. unparseable, or start_date after end_date)

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)