---
title: "List per-post feedback insights"
method: GET
path: "/api/v1/analytics/insights"
tags: ["Analytics"]
---

# List per-post feedback insights

`GET /api/v1/analytics/insights`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/analytics/insights`
- Auth: HTTP bearer

Returns per-post feedback-loop insights (performance tier, diagnosis, next action, metrics, and baseline summary) for the caller's workspace. Filterable by account_id, post_id, and checkpoint. Requires a Pro plan or higher; lower tiers get 403 feature_not_available.

## Query parameters

- `account_id` integer
- `post_id` integer
- `checkpoint` '1h' | '6h' | '24h' | '72h' | '7d'
- `limit` integer

## Response `200`

Feedback insights fetched successfully

- object
  - `insights` object[]
    - `id` string
    - `post_id` integer
    - `social_account_id` integer
    - `username` string, nullable
    - `platform` string
    - `checkpoint` '1h' | '6h' | '24h' | '72h' | '7d'
    - `performance_tier` 'great' | 'good' | 'mixed' | 'poor'
    - `action_type` string
    - `title` string
    - `diagnosis` string
    - `next_action` string
    - `impact_score` number
    - `confidence` number
    - `metrics` object
    - `baseline` object
    - `caption` string, nullable
    - `permalink` string, nullable
    - `published_at` string, nullable
    - `created_at` string

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `403`: Request is authenticated but not allowed
- `429`: Too many requests

---

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