Get Instagram highlight
Get stories from a saved Instagram highlight.
Operation
/v1/instagram/highlights/{highlightId}Headers
API key (`sfk_...`)
Parameters
Numeric Instagram highlight id from a highlight URL.
pattern: ^\d+$
Response fields
Endpoint-specific response payload.
Whether the highlight was resolved: found when metadata and story items are available, or not_found when the highlight does not exist or cannot be accessed.
one of: found, not_found
Highlight metadata when found.
Instagram highlight id.
min 1 chars
Highlight title when available.
Unix timestamp when the highlight was created, when available.
Unix timestamp of the latest story item in the highlight, when available.
Number of story items reported for the highlight.
≥ 0
Highlight cover image when available.
Instagram media id for the cover.
Cover image URL.
Cover image width in pixels when available.
≥ 0
Cover image height in pixels when available.
≥ 0
Highlight owner when available.
Instagram numeric user id.
Instagram username without a leading @.
min 1 chars
Display name when available.
Whether the account is verified.
Profile picture URL when available.
Whether the account is private when known.
Story items in the highlight when found. Empty when `lookupStatus` is `not_found`.
Instagram story item id.
min 1 chars
Instagram media id when distinct from the item id.
Normalized story media type.
one of: image, video, unknown
Unix timestamp when the story item was taken, when available.
Primary image URL when available.
Thumbnail image URL when available.
Direct video URL when available.
Video duration in seconds when available.
≥ 0
Whether the video item has audio when known.
Story media dimensions when available.
Media width in pixels.
≥ 0
Media height in pixels.
≥ 0
Link stickers attached to the story item when available.
Link destination URL.
min 1 chars
Human-readable link label when available.
min 1 chars
Metadata describing the request and billing outcome.
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: v1
Code example
Responses
Highlight details (found or not found in body).
Error codes