---
title: "Get Stories Analytics"
method: GET
path: "/workspaces/{workspace_id}/analytics/stories"
tags: ["analytics"]
---

# Get Stories Analytics

`GET /workspaces/{workspace_id}/analytics/stories`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/workspaces/{workspace_id}/analytics/stories`
- Auth: HTTP bearer

Captured story insights for the selected window.

Story metrics only exist for ~24 hours, so this can only ever return
stories posted *after* capture was switched on for the workspace. There is
no backfill and there never can be.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `tz_offset_minutes` integer
- `since` string, nullable
- `until` string, nullable

## Response `200`

Successful Response

- StoriesAnalyticsResponse
  - `items` StoryInsightItem[], required
    - `id` string, required
    - `permalink` string, nullable, required
    - `thumbnail_url` string, nullable, required
    - `media_type` string, nullable, required
    - `timestamp` string, nullable, required
    - `views` integer, nullable, required
    - `reach` integer, nullable, required
    - `replies` integer, nullable, required
    - `shares` integer, nullable, required
    - `profile_visits` integer, nullable, required
    - `follows` integer, nullable, required
    - `total_interactions` integer, nullable, required
    - `taps_forward` integer, nullable, required
    - `taps_back` integer, nullable, required
    - `exits` integer, nullable, required
    - `swipe_forward` integer, nullable
    - `engagement_rate` number, nullable, required
  - `range` RangeEcho, required: The window a response was actually built for. Always echoed so a caller labels the numbers from what came back, not from request state — the 90-day clamp and the cache can both make those differ.
    - `since` string, required
    - `until` string, required
  - `capture_started_at` string, nullable

## Other responses

- `422`: Validation Error

---

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