List Instagram profile highlights
List story highlight albums for an 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.highlights` list can mean the profile has no visible story highlight albums. When `lookupStatus` is `not_found`, highlights will be empty by design.
Headers
Get your API keyAPI key (`sfk_...`)
Instagram handle whose story highlight albums should be listed.
min 1 chars · max 64 chars
Endpoint-specific response payload.
Whether highlight albums could be listed for this handle.
one of: found, not_found
Story highlight albums for the requested profile.
Instagram highlight album id.
min 1 chars
Album title when Instagram provides one.
Cover thumbnail URL when available.
Cropped square cover thumbnail URL when available.
Album owner metadata when Instagram exposes it on the album.
Instagram numeric user id for the album owner when present.
Instagram username for the album owner when present.
Profile image URL for the album owner when present.
Pagination state for the current response.
Cursor for a next page when pagination is supported. Always null for this endpoint.
Whether another page is available. Always false for this endpoint.
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/mrbeast/highlights" \
-H "x-api-key: YOUR_API_KEY"Responses
Instagram story highlight albums for the requested profile. Inspect `data.lookupStatus` to interpret empty `data.highlights` and not-found outcomes.