List Instagram profile highlights
List story highlight albums for an Instagram profile.
Operation
/v1/instagram/profiles/{handle}/highlightsHeaders
API key (`sfk_...`)
Parameters
Instagram handle whose story highlight albums should be listed.
min 1 chars · max 64 chars
Response fields
Endpoint-specific response payload.
Whether highlight albums could be listed for this handle: found (including empty lists), or not_found when the handle does not resolve or highlights cannot be listed.
one of: found, not_found
Story highlight albums for the requested profile when `lookupStatus` is `found`. Empty when `lookupStatus` is `not_found`, or when the profile has no visible highlight albums.
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
Responses
Instagram story highlight albums for the requested profile. Inspect `data.lookupStatus` to interpret empty `data.highlights` and not-found outcomes.
Error codes