The Instagram connector exposes two endpoints:
| Endpoint | Purpose | Billed |
|---|---|---|
GET /v1/instagram/search | Keyword / hashtag search (native relevance) | per page |
GET /v1/instagram/post/{post_id} | Full post/reel details + all engagement metrics | 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.