> ## 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 Page and post metrics for your Facebook Page.

## Page insights

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/${PAGE_ID}/insights?metric=page_post_engagements,page_follows,page_views_total,page_daily_follows_unique&period=day" \
  -H "Authorization: Bearer ${PAGE_ACCESS_TOKEN}"
```

| Metric                      | Counts                               |
| --------------------------- | ------------------------------------ |
| `page_post_engagements`     | Times people engaged with your posts |
| `page_follows`              | People who follow your Page          |
| `page_views_total`          | Times your Page was viewed           |
| `page_daily_follows_unique` | New followers                        |

`period` is `day`, `week` or `days_28`. Each metric comes back with `values[]`, one entry per period with `value` and `end_time`.

## Post insights

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/${POST_ID}/insights?metric=post_clicks,post_reactions_by_type_total,post_activity_by_action_type" \
  -H "Authorization: Bearer ${PAGE_ACCESS_TOKEN}"
```

| Metric                         | Counts                                              |
| ------------------------------ | --------------------------------------------------- |
| `post_clicks`                  | Clicks anywhere on the post                         |
| `post_activity_by_action_type` | Shares, comments and reactions, broken down by type |
| `post_reactions_by_type_total` | Reactions, broken down by type                      |

Post metrics are lifetime totals and take no `period`.

## What to expect from the data

Data can lag up to 48 hours. Metrics Meta has retired return an error naming the metric; drop it and keep the rest.

## Read insights with the CLI

```bash theme={null}
# Page, default metrics, per day
hookmyapp facebook insights --channel ch_xxxxxxxx

# Page, chosen metrics per week
hookmyapp facebook insights --channel ch_xxxxxxxx --metric page_follows page_views_total --period week --json

# One post
hookmyapp facebook insights --channel ch_xxxxxxxx --post <page-id>_<post-id>
```

## Read insights with MCP

`get_facebook_insights` reads the Page when called with only the channel, and one post when `postId` is set. `metrics` and `period` are optional and default to the tables above.

```text theme={null}
Use HookMyApp MCP to compare this week's Page impressions with last week's on Facebook channel ch_xxxxxxxx.
```

## Next steps

* [Publish](/facebook/publish): Get post ids for post insights.
* [Your Page](/facebook/cli#facebook-commands): Read the Page profile and follower count.