Your posts and profile

List your posts

This is where media ids come from. Post insights, comments, and share calls all take a media id from this list. Story metrics use ids from your active stories instead, and account insights take your account id directly.

curl "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/media?fields=id,caption,media_type,media_url,permalink,timestamp,like_count,comments_count" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

The response is newest first and paginated. Follow paging.next for older posts.

Get one post

curl --globoff "https://gateway.hookmyapp.com/meta/v25.0/${MEDIA_ID}?fields=id,caption,media_type,media_product_type,media_url,permalink,timestamp,like_count,comments_count,children{media_url,media_type}" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

children returns the items inside a carousel.

Field	What you get
`media_type`	`IMAGE`, `VIDEO`, or `CAROUSEL_ALBUM`
`media_product_type`	`FEED`, `REELS`, or `STORY`
`like_count`, `comments_count`	Engagement counts
`permalink`	Public URL of the post
`media_url`	Direct media URL. Expires, so fetch it fresh

Your active stories

curl "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/stories?fields=id,media_type,media_url,timestamp" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Only stories from the last 24 hours appear. Expired stories are gone from this list.

Posts you are tagged in

curl "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/tags?fields=id,username,media_type,media_url,caption" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Returns posts by other accounts that tagged your account.

Your profile

curl "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}?fields=username,name,biography,website,profile_picture_url,followers_count,follows_count,media_count" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Next steps

Insights: Reach and views for any media id from this list.
Comments: Reply to and moderate comments on a post.
Send one of your posts: Share a post inside a DM.

Getting started

Sending & receiving

Publish & engage

Tools

API Reference

Your posts and profile

List your posts

Get one post

Your active stories

Posts you are tagged in

Your profile

Next steps

​List your posts

​Get one post

​Your active stories

​Posts you are tagged in

​Your profile

​Next steps

List your posts

Get one post

Your active stories

Posts you are tagged in

Your profile

Next steps