List Instagram profile posts
Get posts from a specific Instagram profile.
Use `data.lookupStatus` for the domain outcome; call `GET /v1/instagram/profiles/{handle}` when you need full profile cards and related fields.
When `lookupStatus` is `found`, an empty `data.posts` page with `hasMore: false` can still mean a public profile with no posts in range. When `lookupStatus` is `private` or `not_found`, posts will be empty by design.
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
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 page. Inspect `data.lookupStatus` to interpret empty `data.posts` and restriction outcomes.