Instagram

Download Instagram post or reel media

Download Instagram post or reel media

GET/v1/instagram/posts/download
11credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
urlstringrequiredquery

Link to the post or reel.

min 1 chars · max 4096 chars

regionstringoptionalquery

Optional ISO 3166-1 country code for request routing.

Response fields
57

Endpoint-specific response payload.

datalookupStatus
string

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.

datapostid
string

Instagram media id.

min 1 chars

datapostshortcode
string

Public shortcode.

min 1 chars

dataposturl
string

Canonical public Instagram URL for this media.

min 1 chars

datapostcaption
stringnullable

Caption text.

dataposttakenAt
integer

Unix timestamp when the media was taken or posted.

datapostaccessibilityCaption
stringnullableoptional
datapostisAd
booleanoptional
datapostisAffiliate
booleanoptional
datapostisPaidPartnership
booleanoptional

Author when found.

dataownerplatformUserId
stringoptional

Instagram numeric user id.

dataownerhandle
string

Instagram username without a leading @.

min 1 chars

dataownerfullName
stringnullableoptional

Display name when available.

dataownerverified
boolean

Whether the account is verified.

dataowneravatarUrl
stringnullableoptional

Profile picture URL.

dataownerprivateAccount
booleanoptional

Whether the account is private.

Engagement metrics for the media.

datametricslikes
integernullableoptional

Like count when Instagram exposes it.

≥ 0

datametricscomments
integernullableoptional

Comment count when Instagram exposes it.

≥ 0

datametricsplayCount
integernullableoptional

Play or view count for video/reel content when available.

≥ 0

Primary media payload for the post.

datamediamediaType
string

Normalized media type.

one of: image, video, sidecar, unknown

datamediadisplayUrl
stringnullableoptional
datamediathumbnailUrl
stringnullableoptional
datamediavideoUrl
stringnullableoptional
datamediavideoDurationSec
numbernullableoptional

≥ 0

Dimensions for a media item.

datamediadimensionswidth
integer

Media width in pixels.

≥ 0

datamediadimensionsheight
integer

Media height in pixels.

≥ 0

datamediaproductType
stringnullableoptional

Product type when present.

Sidecar children when this is a carousel.

datamediacarouselChildren[]id
stringoptional
datamediacarouselChildren[]shortcode
stringoptional
datamediacarouselChildren[]displayUrl
stringoptional
datamediacarouselChildren[]videoUrl
stringnullableoptional
datamediacarouselChildren[]isVideo
booleanoptional

Permanent CDN URLs when `downloadMedia` was true and media assets are available.

datadownloads[]postId
stringoptional

Post or media id when present.

datadownloads[]originalUrl
string

Original Instagram CDN URL.

datadownloads[]cdnUrl
string

Permanent hosted URL when download succeeded.

datadownloads[]type
string

Asset type.

one of: image, video

datataggedUsers[]handle
string

Tagged username.

min 1 chars

datataggedUsers[]platformUserId
stringoptional
datacoauthors[]handle
string

min 1 chars

datacoauthors[]platformUserId
stringoptional
datacoauthors[]verified
booleanoptional
datacoauthors[]avatarUrl
stringnullableoptional

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/instagram/posts/download?url=https://www.instagram.com/p/DIdOKNpx66J" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Post or reel metadata with hosted media download URLs.