The Instagram connector exposes these endpoints:
| Endpoint | Purpose | Billed |
|---|---|---|
GET /v1/instagram/search | Keyword / hashtag search, relevance-ranked | per page |
GET /v1/instagram/search/boolean | Keyword / boolean search (AND / OR / quoted phrases) | per page |
GET /v1/instagram/post/{post_id} | Full post/reel details + all engagement metrics | per request |
GET /v1/instagram/profile/posts | A public profile's posts, paginated, with engagement metrics | per page |
GET /v1/instagram/profile/stories | A public profile's active stories with direct media links | per request |
Post identifiers
A post is identified by its shortcode — the code in a post URL:
https://www.instagram.com/p/DcghxSFtjRB/
└──────────┘
shortcode = DcghxSFtjRB
You can pass either the bare shortcode (DcghxSFtjRB) or a full URL (/p/…,
/reel/…, /tv/…) — the API normalises it.
Media types
type | Meaning |
|---|---|
image | Single image post |
video | Feed video |
reel | Reel (product_type: clips) |
carousel | Multi-item album |
Reels expose play/view counts in the post response.