Get Instagram highlight
Get a saved Instagram highlight and the stories inside it by highlight id.
Headers
Get your API keyAPI key (`sfk_...`)
Numeric Instagram highlight id, or an Instagram /stories/highlights/{id} URL.
Endpoint-specific response payload.
`found`, or `not_found` when the highlight doesn't exist or can't be shown (for example when its account is private).
one of: found, not_found
The highlight. Null when not found.
Highlight id.
pattern: ^\d+$
Highlight title.
Cover image. On a profile's first lookup it can be a smaller one. Instagram CDN URL; it expires after a while.
Stories in the highlight. Can be null on a profile's first lookup.
≥ 0
When it was created. Can be null on a profile's first lookup.
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.
The stories in the highlight, in order, each with `kind: story`. Empty when not found.
Media id.
pattern: ^\d+$
Shortcode used in the media URL. Null for stories.
Public URL: `/reel/` for Reels, `/p/` otherwise. Null for stories.
`post`, `reel` or `story`.
one of: post, reel, story
`image`, `video` or `carousel`. Null when unknown.
one of: image, video, carousel, null
Caption text.
Alt text Instagram generated or the owner wrote. Null when none or not reported.
When it was posted.
The account that posted it. Null when unknown.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Engagement counts. Null when this view doesn't report one.
Likes. Null when hidden or not reported.
≥ 0
Comments.
≥ 0
Plays, for videos. Counts Instagram plays only, not plays of a cross-posted copy on other apps.
≥ 0
Shares.
≥ 0
Saves.
≥ 0
Whether the owner hides the like count.
Image, or a video's cover image. Instagram CDN URL; it expires after a while.
Small preview image. Instagram CDN URL; it expires after a while.
Video file. Instagram CDN URL; it expires after a while.
Video length in seconds, to the millisecond.
Pixel size. Null when unknown.
Width in pixels.
≥ 0
Height in pixels.
≥ 0
Every item of a carousel, in order. Null when not a carousel.
Media id of this item.
pattern: ^\d+$
`image` or `video`. Null when unknown.
one of: image, video, null
Image, or a video's cover. Instagram CDN URL; it expires after a while.
Video file. Instagram CDN URL; it expires after a while.
Video length in seconds, to the millisecond. Null for images.
Pixel size. Null when unknown.
Width in pixels.
≥ 0
Height in pixels.
≥ 0
Alt text Instagram generated or the owner wrote. Null when none or not reported.
Music or original audio. On a story, the music sticker. Null when none.
Audio id.
pattern: ^\d+$
Song or sound title.
Artist name.
Whether it is original audio rather than licensed music.
Username of the account behind original audio.
Collab co-authors. Empty when none.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Accounts tagged in the media. Empty when none. Null when this view doesn't carry tags.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Tagged location. Null when none.
Location id.
pattern: ^\d+$
Place name.
Latitude.
Longitude.
Whether it is labelled as a paid partnership.
Brands named in the paid-partnership label. Empty when it is not a partnership. Null when this view doesn't say.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
Whether the owner turned comments off. Null when this view doesn't say.
Whether the owner pinned it to their profile (to the Reels tab, when listed there). Null when this view doesn't say.
Story-only details. Null for posts and Reels.
When the story expires, or expired for a story kept in a highlight.
Link stickers.
Link destination: the address the sticker opens, not Instagram's redirect.
min 1 chars
Text shown on the sticker. Can be null on a profile's first lookup.
Accounts mentioned. On a profile's first lookup, an account's `id`, `avatarUrl` and `verified` can be null.
Instagram user id.
pattern: ^\d+$
Username, without @.
Display name.
Profile picture. Instagram CDN URL; it expires after a while.
Whether the account is verified.
Whether the account is private.
The post or Reel the story re-shares. Null when none.
Media id of the shared post or Reel.
pattern: ^\d+$
Shortcode of the shared post or Reel.
min 1 chars
Metadata about the API response.
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: v2
Code example
curl "https://api.socialfetch.dev/v2/instagram/highlights/18195781759377100" \
-H "x-api-key: YOUR_API_KEY"Responses
Instagram highlight with its stories.