List Instagram profile posts
List posts from an Instagram profile by handle — List Instagram profile posts.
Headers
Get your API keyAPI key (`sfk_...`)
Instagram handle whose posts should be listed.
min 1 chars · max 64 chars
Opaque pagination cursor from a previous response (`data.page.nextCursor`).
min 1 chars
Endpoint-specific response payload.
Whether posts could be listed for this handle.
one of: found, private, not_found
Instagram posts for the requested profile page.
Instagram media id for this item (vendor-defined composite id).
min 1 chars
Public shortcode used in the Instagram post URL.
min 1 chars
Normalized media type.
one of: image, video, sidecar, unknown
Caption text when Instagram provides one.
When the media was taken or posted (Unix epoch seconds).
Canonical public Instagram URL for this media.
min 1 chars
Primary display image URL when available.
Thumbnail or cover image URL when available.
Direct video URL when this item is a video and a URL is available.
Like count when Instagram exposes it.
≥ 0
Comment count when Instagram exposes it.
≥ 0
Play or view count for video content when Instagram exposes it (Instagram-only views when distinguishable).
≥ 0
Width and height when available.
Media width in pixels.
≥ 0
Media height in pixels.
≥ 0
Users tagged in the media when Instagram exposes them.
Tagged Instagram username without a leading @.
min 1 chars
Instagram numeric user id for the tagged account when present.
Pagination state for the current response.
Cursor to pass as `cursor` in the next request when more posts are available.
Whether another page of posts is available from Instagram.
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
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/profiles/charlidamelio/posts" \
-H "x-api-key: YOUR_API_KEY"Responses
Instagram posts for the requested profile.