---
title: "List all insights"
method: GET
path: "/social/{connection_id}/insight"
tags: ["social", "insight"]
---

# List all insights

`GET /social/{connection_id}/insight`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/social/{connection_id}/insight`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string, date-time
- `sort` 'name' | 'updated_at' | 'created_at'
- `order` 'asc' | 'desc'
- `query` string
- `profile_id` string
- `post_id` string
- `start_gte` string
- `end_lt` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- SocialInsight[]
  - `id` string: Unique identifier for the insight data point
  - `created_at` string, date-time: When the insight was recorded (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `profile_id` string: The social profile these stats belong to
  - `post_id` string: Optional: the post these stats belong to
  - `date` string, date-time: The day/timestamp of the data point
  - `period` 'DAY' | 'WEEK' | 'MONTH' | 'LIFETIME' | 'TOTAL' | 'OTHER': The aggregation period of the value
  - `metric` 'FOLLOWERS' | 'FOLLOWING' | 'POSTS' | 'IMPRESSIONS' | 'REACH' | 'ENGAGEMENT' | 'PROFILE_VIEWS' | 'CLICKS' | 'VIDEO_VIEWS' | 'LIKES' | 'COMMENTS' | 'SHARES' | 'SAVES' | 'OTHER': The metric being reported
  - `value` number: The metric value
  - `metadata` SocialMetadata[]
    - `id` string
    - `slug` string
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)