List Instagram profile highlights

List an Instagram profile's story highlights by handle, profile URL or user id.

GET/v2/instagram/profiles/{profile}/highlights
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
profilestringrequiredpath

Handle, profile URL or numeric user id.

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

`found`; `private` when the account is private (only what Instagram shows publicly is returned); `not_found` when it doesn't exist.

one of: found, private, not_found

The profile's story highlights. Empty when there are none.

datahighlights[]id
string

Highlight id.

pattern: ^\d+$

datahighlights[]title
stringnullable

Highlight title.

datahighlights[]coverUrl
stringnullable

Cover image. On a profile's first lookup it can be a smaller one. Instagram CDN URL; it expires after a while.

datahighlights[]mediaCount
integernullable

Stories in the highlight. Can be null on a profile's first lookup.

≥ 0

datahighlights[]createdAt
stringnullable

When it was created. Can be null on a profile's first lookup.

datahighlights[]updatedAt
stringnullable

When it was last changed: a story was added, or it was edited. Never before `createdAt`. Can be null on a profile's first lookup.

Pagination state. Every highlight comes in one response, so `hasMore` is always false.

datapagekind
string

one of: cursor, offset, page

datapagenextCursor
stringnullable
datapagehasMore
booleannullable

Null when continuation is unknown for this page.

datapagestart
integernullable

≥ 0

datapagepage
integernullable

≥ 0

datapagecount
integernullable

≥ 0

datapagereturnedCount
integer

≥ 0

datapagetotal
integernullable

≥ 0

datapagetotalPages
integernullable

≥ 0

Metadata about the API response.

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: v2

Code example

curl "https://api.socialfetch.dev/v2/instagram/profiles/nasa/highlights" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Story highlights for the requested profile.