---
title: "Get Trial Reels Analytics"
method: GET
path: "/workspaces/{workspace_id}/analytics/trial-reels"
tags: ["analytics"]
---

# Get Trial Reels Analytics

`GET /workspaces/{workspace_id}/analytics/trial-reels`

## 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/trial-reels`
- Auth: HTTP bearer

Published trial reels in the window, each with its stored snapshot series.

Everything here is ReelDrop's own sampling (see the Poller's trial sweep):
Instagram's API has no trial-specific insights and does not report whether a
trial has graduated, so the series and the surge heuristic are the product.

## Path parameters

- `workspace_id` string, required

## Query parameters

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

## Response `200`

Successful Response

- TrialReelsResponse
  - `items` TrialReelItem[], required
    - `id` string, required
    - `caption` string, required
    - `published_at` string, nullable, required
    - `ig_permalink` string, nullable, required
    - `thumbnail_url` string, nullable, required
    - `graduation_strategy` string, required
    - `tracking_until` string, nullable, required
    - `tracking_active` boolean, required
    - `snapshot_count` integer, required
    - `views` integer, nullable, required
    - `reach` integer, nullable, required
    - `likes` integer, nullable, required
    - `comments` integer, nullable, required
    - `shares` integer, nullable, required
    - `saved` integer, nullable, required
    - `engagement_rate` number, nullable, required
    - `views_24h` integer, nullable, required
    - `views_72h` integer, nullable, required
    - `reach_surge_pct` number, nullable, required
    - `reach_surge_at` string, nullable, required
    - `series` TrialSnapshotPoint[], required
      - `captured_at` string, required
      - `hours_since_publish` number, required
      - `views` integer, nullable, required
      - `reach` integer, nullable, required
      - `likes` integer, nullable, required
      - `comments` integer, nullable, required
      - `shares` integer, nullable, required
      - `saved` integer, nullable, required
      - `total_interactions` integer, nullable, required
      - `follower_count` integer, 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

## 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)
