# Instagram API

Get public Instagram profiles, posts, reels, comments, followers, stories, search, and more through one stable API.

Status: Available in Test and Live environments. Last reviewed August 17, 2026.
Example: GET https://api.openhandle.dev/v1/instagram/profiles/@{username}
Every call is one request at the same price. All endpoints accept the freshness parameter.

## Endpoints (45 operations)

| Operation | Endpoint |
|---|---|
| Get a profile | GET /v1/instagram/profiles/{identifier} |
| List profile posts | GET /v1/instagram/profiles/{identifier}/posts |
| List profile reels | GET /v1/instagram/profiles/{identifier}/reels |
| List profile videos | GET /v1/instagram/profiles/{identifier}/videos |
| List tagged posts | GET /v1/instagram/profiles/{identifier}/tagged-posts |
| List profile reposts | GET /v1/instagram/profiles/{identifier}/reposts |
| List pinned posts | GET /v1/instagram/profiles/{identifier}/pinned-posts |
| List followers | GET /v1/instagram/profiles/{identifier}/followers |
| List following | GET /v1/instagram/profiles/{identifier}/following |
| Search followers | GET /v1/instagram/profiles/{identifier}/followers/search?q={query} |
| Search following | GET /v1/instagram/profiles/{identifier}/following/search?q={query} |
| List suggested profiles | GET /v1/instagram/profiles/{identifier}/suggested |
| List related profiles | GET /v1/instagram/profiles/{identifier}/related |
| Get a post | GET /v1/instagram/posts/{identifier} |
| List comments | GET /v1/instagram/posts/{identifier}/comments |
| List replies to a comment | GET /v1/instagram/posts/{identifier}/comments/{commentId}/replies |
| List tagged users | GET /v1/instagram/posts/{identifier}/tagged-users |
| List post likers | GET /v1/instagram/posts/{identifier}/likers |
| Search profiles | GET /v1/instagram/search/profiles?q={query} |
| Search reels | GET /v1/instagram/search/reels?q={query} |
| Search music/audio | GET /v1/instagram/search/music?q={query} |
| Search hashtags | GET /v1/instagram/search/hashtags?q={query} |
| Search places | GET /v1/instagram/search/places?q={query} |
| Get a hashtag | GET /v1/instagram/hashtags/{name} |
| List hashtag posts | GET /v1/instagram/hashtags/{name}/posts |
| List hashtag reels | GET /v1/instagram/hashtags/{name}/reels |
| Get a location | GET /v1/instagram/locations/{id} |
| List location posts | GET /v1/instagram/locations/{id}/posts |
| Get music/audio | GET /v1/instagram/music/{identifier} |

The complete 45-operation surface also includes public Stories, Highlights, profile-about data, business recommendations, combined search, comment likers, post insights and metadata, audio streams, and location guides. Every operation has its own generated page in the API reference.

Field reference: https://openhandle.dev/docs/platforms/instagram.md (generated from the API, the source of truth for fields and types).

## Limitations

- Public accounts and public content only.
- Unavailable platform metrics are returned as null, never inferred as zero.

## FAQ

### Do I need Meta app approval?

No. Openhandle handles the upstream integration; your application uses an Openhandle API key.

### Can I test without making live requests?

Yes. Test keys use a deterministic synthetic dataset and never contact Instagram.

### Can I use a username instead of an ID?

Yes. Put @username or the platform ID in any profile path, including /posts. Openhandle remembers which ID belongs to which username.

Docs: https://openhandle.dev/docs/platforms/instagram · Pricing: https://openhandle.dev/pricing.md