Get Instagram profile
Looks up an Instagram profile by handle. Outcomes such as found, private, or not found are indicated in `data.lookupStatus`.
Operation
/v1/instagram/profiles/{handle}Headers
API key (`sfk_...`)
Parameters
Instagram handle to look up, with or without a leading @.
min 1 chars · max 64 chars
Response fields
Endpoint-specific response payload.
Whether the profile was found, private, or not found.
one of: found, private, not_found
Profile details when available.
Social platform for this profile.
one of: instagram
Instagram username without the leading @.
Public display name on the Instagram profile.
Profile biography text.
Best available square avatar image URL.
Higher-resolution avatar URL when available.
Whether Instagram marks the profile as verified.
Canonical public Instagram profile URL.
min 1 chars
Whether the account is private.
Instagram numeric user id as a string.
Whether the account is a business account.
Whether the account is a professional/creator account.
Category label when Instagram provides one.
Primary external link from the profile.
Number of story highlights on the profile.
≥ 0
Structured bio links when available.
Link title shown on the profile.
Destination URL.
min 1 chars
Profile metrics when available.
Follower count reported by Instagram.
≥ 0
Following count reported by Instagram.
≥ 0
Total public posts count on the profile grid.
≥ 0
Recent grid posts from the profile when available.
Instagram media id for this post (vendor-defined).
Public shortcode for the post URL.
Normalized media type.
one of: video, image, sidecar, unknown
Post caption when available.
When the media was taken or posted (Unix epoch seconds).
Comment count when available.
≥ 0
Like count when available.
≥ 0
Video view count for video posts when available.
≥ 0
Primary display image URL.
Thumbnail image URL.
Direct video URL when available.
Width and height when available.
Media width in pixels.
≥ 0
Media height in pixels.
≥ 0
Suggested related accounts when available.
Instagram user id for the account.
Instagram username.
Display name.
Profile picture URL.
Whether the account is verified.
Whether the account is private.
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
Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.
Error codes
Showcase products
Lists TikTok Shop products featured on a creator profile showcase with cursor-based pagination. This route does not expose `lookupStatus`; an empty `data.products` array can occur when there are no showcased products, the profile is private, or other cases—call `GET /v1/tiktok/profiles/{handle}` first when you need explicit account status.
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.