> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookmyapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get media insights

> Read metrics for a single post, reel, or story.

## Authentication

Use the `hmat_` channel token from `GET /meta/channels/{id}/token` or `hookmyapp channels env <channel>`. Do not use an `hmok_` API key for this call.

```bash theme={null}
Authorization: Bearer hmat_...
```

## Path parameters

<ParamField path="mediaId" type="string" required>
  The published media ID.
</ParamField>

## Query parameters

<ParamField query="metric" type="string" required>
  Comma-separated metrics: `views`, `reach`, `likes`, `comments`, `saved`, `shares`, `total_interactions`; reels also accept `ig_reels_avg_watch_time` and `reels_skip_rate`; stories also accept `navigation` and `replies`. Use `likes` and `comments` when you need the separate counts instead of the combined `total_interactions`.
</ParamField>

Story metrics are only available while the story is live — 24 hours.

## Example

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/{MEDIA_ID}/insights?metric=views,reach,saved" \
  -H "Authorization: Bearer hmat_..."
```

## Successful response

```json theme={null}
{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": 830 }],
      "id": "17850000000000000/insights/views/lifetime"
    }
  ]
}
```