Social Fetch
Instagram

Get Instagram highlight

Get stories from a saved Instagram highlight.

GET/v1/instagram/highlights/{highlightId}
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
highlightId*stringpath

Numeric Instagram highlight id from a highlight URL.

pattern: ^\d+$

Response fields
40

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
integernullable

Unix timestamp when the highlight was created, when available.

datahighlightlatestItemAt
integernullable

Unix timestamp of the latest story item in the highlight, 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[]takenAt
integernullable

Unix timestamp when the story item was taken, when available.

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

Code example

curl "https://api.socialfetch.dev/v1/instagram/highlights/17929440964811872" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Highlight details (found or not found in body).

On this page

No Headings