List Instagram 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.
Operation
/v1/instagram/profiles/{handle}/postsHeaders
API key (`sfk_...`)
Parameters
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
Response fields
Endpoint-specific response payload.
Instagram posts for the requested profile page. An empty array can represent a private account, a missing handle, or simply no posts—use the profile endpoint first when you need explicit `lookupStatus`.
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
Responses
Instagram posts for the requested profile page. Empty `data.posts` is ambiguous without a profile preflight—see the operation description.
Error codes
Profile
Looks up an Instagram profile by handle. Outcomes such as found, private, or not found are indicated in `data.lookupStatus`.
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.