---
title: "Retrieve an insight"
method: GET
path: "/social/{connection_id}/insight/{id}"
tags: ["social", "insight"]
---

# Retrieve an insight

`GET /social/{connection_id}/insight/{id}`

## Request

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

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

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