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

# Your posts and profile

> List your posts, read engagement counts, and read your 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](#your-active-stories) instead, and account insights take your account id directly.

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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](/instagram/insights): Reach and views for any media id from this list.
* [Comments](/instagram/comments): Reply to and moderate comments on a post.
* [Send one of your posts](/instagram/send-messages/share-post): Share a post inside a DM.