List Instagram profile highlights

List story highlight albums for an Instagram profile by handle.

GET/v1/instagram/profiles/{handle}/highlights
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

Instagram handle whose story highlight albums should be listed.

min 1 chars · max 64 chars

Response fields
19

Endpoint-specific response payload.

datalookupStatus
string

Whether highlight albums could be listed for this handle.

one of: found, not_found

Story highlight albums for the requested profile.

datahighlights[]id
string

Instagram highlight album id.

min 1 chars

datahighlights[]title
stringnullable

Album title when Instagram provides one.

datahighlights[]coverThumbnailUrl
stringoptional

Cover thumbnail URL when available.

datahighlights[]croppedCoverThumbnailUrl
stringoptional

Cropped square cover thumbnail URL when available.

Album owner metadata when Instagram exposes it on the album.

datahighlights[]ownerplatformUserId
stringoptional

Instagram numeric user id for the album owner when present.

datahighlights[]ownerhandle
stringoptional

Instagram username for the album owner when present.

datahighlights[]owneravatarUrl
stringoptional

Profile image URL for the album owner when present.

Pagination state for the current response.

datapagenextCursor
stringnullable

Cursor for a next page when pagination is supported. Always null for this endpoint.

datapagehasMore
boolean

Whether another page is available. Always false for this endpoint.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

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.