Insights

Account insights

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.
Below 100 followers, Meta returns an error instead of data.

Media insights

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.
You get the metrics that resolved, plus an unavailable list naming the ones that did not.

Read insights with the CLI

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

Use HookMyApp MCP to get this week's reach and views for Instagram channel ch_xxxxxxxx.

See MCP for setup.

Next steps

Publish content: Publish the posts these metrics measure.
Comments: See who is engaging and reply.

Getting started

Sending & receiving

Publish & engage

Tools

API Reference

Account insights

Demographics

Media insights

What to expect from the data

Read insights with the CLI

Read insights with MCP

Next steps

​Account insights

​Demographics

​Media insights

​What to expect from the data

​Read insights with the CLI

​Read insights with MCP

​Next steps

Account insights

Demographics

Media insights

What to expect from the data

Read insights with the CLI

Read insights with MCP

Next steps