Get Instagram highlight

Get stories inside a saved Instagram highlight by highlight id.

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

API key (`sfk_...`)

Parameters
1
highlightIdstringrequiredpath

Numeric Instagram highlight id from a highlight URL.

pattern: ^\d+$

Response fields
41

Endpoint-specific response payload.

datalookupStatus
string

Whether the highlight was resolved.

one of: found, not_found

Highlight metadata when found.

datahighlightid
string

Instagram highlight id.

min 1 chars

datahighlighttitle
stringnullable

Highlight title when available.

datahighlightcreatedAt
stringnullable

When the highlight was created (ISO-8601), when available.

datahighlightlatestItemAt
stringnullable

When the latest story item was added (ISO-8601), when available.

datahighlightmediaCount
integernullable

Number of story items reported for the highlight.

≥ 0

Highlight cover image when available.

datahighlightcovermediaId
stringoptional

Instagram media id for the cover.

datahighlightcoverurl
stringnullableoptional

Cover image URL.

datahighlightcoverwidth
integernullableoptional

Cover image width in pixels when available.

≥ 0

datahighlightcoverheight
integernullableoptional

Cover image height in pixels when available.

≥ 0

Highlight owner when available.

datahighlightownerplatformUserId
stringoptional

Instagram numeric user id.

datahighlightownerhandle
stringoptional

Instagram username without a leading @.

min 1 chars

datahighlightownerfullName
stringnullableoptional

Display name when available.

datahighlightownerverified
booleanoptional

Whether the account is verified.

datahighlightowneravatarUrl
stringnullableoptional

Profile picture URL when available.

datahighlightownerprivateAccount
booleanoptional

Whether the account is private when known.

Story items in the highlight.

dataitems[]id
string

Instagram story item id.

min 1 chars

dataitems[]mediaId
stringoptional

Instagram media id when distinct from the item id.

dataitems[]mediaType
string

Normalized story media type.

one of: image, video, unknown

dataitems[]createdAt
stringnullable

When the story item was taken or posted (ISO-8601).

dataitems[]displayUrl
stringnullableoptional

Primary image URL when available.

dataitems[]thumbnailUrl
stringnullableoptional

Thumbnail image URL when available.

dataitems[]videoUrl
stringnullableoptional

Direct video URL when available.

dataitems[]videoDurationSec
numbernullableoptional

Video duration in seconds when available.

≥ 0

dataitems[]hasAudio
booleannullableoptional

Whether the video item has audio when known.

Story media dimensions when available.

dataitems[]dimensionswidth
integer

Media width in pixels.

≥ 0

dataitems[]dimensionsheight
integer

Media height in pixels.

≥ 0

Link stickers attached to the story item when available.

dataitems[]linkStickers[]url
stringoptional

Link destination URL.

min 1 chars

dataitems[]linkStickers[]displayUrl
stringoptional

Human-readable link label when available.

min 1 chars

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/highlights/17929440964811872" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Highlight details.