---
title: "Published posts and their reach, day by day"
method: GET
path: "/api/v1/analytics/momentum"
tags: ["analytics"]
---

# Published posts and their reach, day by day

`GET /api/v1/analytics/momentum`

## Request

- Base URL: `https://api.cadencz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cadencz.com/api/v1/analytics/momentum`
- Auth: HTTP bearer

The Home page's momentum read for a workspace that has already published. Post counts are exact and unlimited; reach and engagement follow the plan's measured platforms, like `/analytics/summary`.

## Query parameters

- `weeks` integer

## Response `200`

Successful Response

- AnalyticsMomentum: The "keep going" read: what you have shipped and what it has earned, day by day, for the last few weeks. Built for a workspace that has already published a few posts — the point is a bar that only ever climbs. Post counts come from our own rows and are exact. Reach and engagement come from the latest snapshot per post, attributed to the day the post went out, and only for platforms the plan measures — the same rules as the summary.
  - `posts_published` integer, required
  - `first_published_at` string, date-time, nullable, required
  - `weeks` integer, required
  - `days` AnalyticsMomentumDay[], required
    - `date` string, required
    - `posts` integer, required
    - `impressions` integer, nullable, required
    - `engagements` integer, required
  - `total_impressions` integer, nullable, required
  - `total_engagements` integer, required
  - `all_time_impressions` integer, nullable
  - `all_time_engagements` integer
  - `weeks_active` integer, required
  - `current_streak_weeks` integer, required
  - `measured_platforms` string[]

## Other responses

- `401`: Missing or invalid Supabase bearer token.
- `422`: Validation Error

---

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