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

# Insights

> Read account and media metrics for your Instagram professional account.

## Account insights

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/insights?metric=reach,views,total_interactions&period=day&metric_type=total_value" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"
```

| Metric                  | Counts                                                                                   |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| `reach`                 | Unique accounts that saw your content                                                    |
| `views`                 | Times your content was played or displayed. Replaces the deprecated `impressions` metric |
| `likes`                 | Likes on your content                                                                    |
| `comments`              | Comments on your content                                                                 |
| `shares`                | Shares of your content                                                                   |
| `saves`                 | Saves of your content                                                                    |
| `total_interactions`    | Likes, comments, shares, and saves combined                                              |
| `accounts_engaged`      | Unique accounts that interacted with you                                                 |
| `profile_links_taps`    | Taps on links in your profile                                                            |
| `follows_and_unfollows` | Follows and unfollows                                                                    |

Some metrics accept a `breakdown` parameter: `follow_type`, `media_product_type`, or `contact_button_type`.

### Demographics

`follower_demographics` and `engaged_audience_demographics` need at least 100 followers and a `timeframe` parameter.<br />
Below 100 followers, Meta returns an error instead of data.

## Media insights

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

| Metric                    | Counts                                      |
| ------------------------- | ------------------------------------------- |
| `views`                   | Times the post was played or displayed      |
| `reach`                   | Unique accounts that saw the post           |
| `likes`                   | Likes                                       |
| `comments`                | Comments                                    |
| `saved`                   | Saves                                       |
| `shares`                  | Shares                                      |
| `total_interactions`      | Likes, comments, shares, and saves combined |
| `ig_reels_avg_watch_time` | Average watch time (reels)                  |
| `reels_skip_rate`         | Skip rate (reels)                           |
| `navigation`              | Taps forward, back, and exits (stories)     |
| `replies`                 | Replies (stories)                           |

## What to expect from the data

* Data can lag up to 48 hours. A fresh post shows nothing at first.
* Story metrics are only available while the story is live — 24 hours.
* Metric values below 5 are withheld: Meta returns error code 10 instead of the value.
* No recorded activity returns an empty `data` array, not a zero.

The HookMyApp CLI and MCP tool fetch each metric separately, so one unavailable metric never fails the whole call.<br />
You get the metrics that resolved, plus an `unavailable` list naming the ones that did not.

## Read insights with the CLI

```bash theme={null}
# Account insights
hookmyapp instagram insights --channel @your-handle

# Media insights, chosen metrics, machine-readable
hookmyapp instagram insights --channel @your-handle --media <media-id> --metrics views,reach --json
```

## Read insights with MCP

Ask your agent for the metrics you want. The `get_instagram_insights` tool reads account or media metrics, including the profile counters like follower count.

```text theme={null}
Use HookMyApp MCP to get this week's reach and views for Instagram channel ch_xxxxxxxx.
```

See [MCP](/instagram/mcp-server) for setup.

## Next steps

* [Publish content](/instagram/publish-content): Publish the posts these metrics measure.
* [Comments](/instagram/comments): See who is engaging and reply.