Get Instagram post or reel
Returns public metadata for a single Instagram post or reel. Play counts reflect Instagram-native totals when distinguishable from cross-posted network totals.
Operation
/v1/instagram/postsPricing
- Base
- 1 credit
downloadMedia= true— Hosted media download- +10 credits
Headers
API key (`sfk_...`)
Parameters
Link to the post or reel.
min 1 chars · max 4096 chars
Optional two-letter region (country code) for request routing.
min 1 chars
When true, returns a smaller response with fewer fields.
When true, returns permanent CDN URLs for media in `downloads`. Adds 10 credits (11 total including the base lookup).
Response fields
Endpoint-specific response payload.
Whether the post or reel was resolved.
one of: found, not_found
Post details when found.
Instagram media id.
min 1 chars
Public shortcode.
min 1 chars
Canonical public Instagram URL for this media.
min 1 chars
Caption text.
Unix timestamp when the media was taken or posted.
Author when found.
Instagram numeric user id.
Instagram username without a leading @.
min 1 chars
Display name when available.
Whether the account is verified.
Profile picture URL.
Whether the account is private.
Engagement metrics for the media.
Like count when Instagram exposes it.
≥ 0
Comment count when Instagram exposes it.
≥ 0
Play or view count for video/reel content when available.
≥ 0
Primary media payload for the post.
Normalized media type.
one of: image, video, sidecar, unknown
≥ 0
Dimensions for a media item.
Media width in pixels.
≥ 0
Media height in pixels.
≥ 0
Product type when present (e.g. clips).
Sidecar children when this is a carousel.
Permanent CDN URLs when `downloadMedia` was true and media assets are available.
Post or media id when present.
Original Instagram CDN URL.
Permanent hosted URL when download succeeded.
Asset type.
one of: image, video
Tagged username.
min 1 chars
min 1 chars
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Post or reel metadata (found or not found in body).
Error codes
Profile posts
Lists public posts for an Instagram profile with cursor-based pagination. Private accounts, missing handles, and accounts with no posts can all surface as HTTP `200` with an empty `data.posts` page—this route does not expose `lookupStatus`. Call `GET /v1/instagram/profiles/{handle}` first when you need explicit `found` / `private` / `not_found` before interpreting an empty list.
Post comments
Lists top-level comments for a public Instagram post or reel URL with optional cursor-based pagination.