Pricing
- Base
- 1 credit
downloadMedia= true— Hosted media download- +10 credits
Headers
Get your API keyAPI key (`sfk_...`)
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).
Endpoint-specific response payload.
Whether the post or reel was resolved. Restricted covers age-gated or otherwise non-scrapable content.
one of: found, not_found, restricted
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.
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
curl "https://api.socialfetch.dev/v1/instagram/posts?url=https://www.instagram.com/p/DIdOKNpx66J" \
-H "x-api-key: YOUR_API_KEY"Responses
Post or reel metadata. Check `data.lookupStatus` for `found`, `not_found`, or `restricted`.