Instagram Highlight detail API
Fetch the details and media items of a single Instagram story highlight by id.
$1.20/1k req, pay per request, no subscription.
{"id": "3402918475610233981","code": "C7fT2xLoAbD","mediaType": 2,"image": "https://cdninstagram.com/glacier-cover.jpg","videoUrl": "https://cdninstagram.com/glacier.mp4","durationSeconds": 12.4,"hasAudio": true,"createdUtc": number,... 4 more fields}
Pricing
Instagram Highlight detail API pricing
Try it
Get Instagram highlight detail in one request
This sample shows 22 of 23 fields. See every field
{
"found": true,
"data": {
"id": "18201653992314974",
"title": "Iceland 2025",
"mediaCount": 3,
"createdUtc": 1718409600,
"ownerHandle": "nadia.travels",
"coverUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/iceland-highlight-cover.jpg",
"avatarUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/nadia-travels-profile.jpg",
"items": [
{
"id": "3402918475610233981",
"code": "C7fT2xLoAbD",
"mediaType": 2,
"image": "https://cdninstagram.com/glacier-cover.jpg",
"videoUrl": "https://cdninstagram.com/glacier.mp4",
"durationSeconds": 12.4,
"hasAudio": true
},
{
"id": "3402918475610234109",
"code": "C7fT3aPoXyZ",
"mediaType": 1,
"image": "https://scontent.cdninstagram.com/v/t51.2885-15/iceland-waterfall.jpg",
"width": 1080,
"height": 1920,
"createdUtc": 1718413200,
"productType": "story",
"paidPartnership": false
},
{
"id": "3402918475610234255",
"code": "C7fT4mZoQeF",
"mediaType": 1,
"image": "https://scontent.cdninstagram.com/v/t51.2885-15/iceland-hotsprings.jpg",
"width": 1080,
"height": 1920,
"createdUtc": 1718416800,
"productType": "story",
"paidPartnership": true
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- idstring
18201653992314974
The id of the highlight to retrieve details for.
Response
JSON, one example value per field.
The highlight record, or null when nothing was found.
- avatarUrlstring
https://scontent.cdninstagram.com/v/t51.2885-19/nadia-travels-profile.jpg
Profile picture URL of the account that owns the highlight.
- coverUrlstring
https://scontent.cdninstagram.com/v/t51.2885-19/iceland-highlight-cover.jpg
URL of the highlight cover image. Populated whenever the provider has data for the entity.
- createdUtcnumber
1718409600
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- idstring
18201653992314974
Highlight identifier. Populated whenever the provider has data for the entity.
- mediaCountinteger
3
Number of media items in the highlight.
- ownerHandlestring
nadia.travels
Handle of the account that owns the highlight. Populated whenever the provider has data for the entity.
- titlestring
Iceland 2025
Highlight title. Populated whenever the provider has data for the entity.
The media items inside the highlight, in the order the upstream returned them.
- codestring
C7fT2xLoAbD
Instagram media shortcode.
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- durationSecondsnumber
12.4
Video duration in seconds, when the item is a video.
- hasAudioboolean
true
True when the media carries an audio track.
- heightinteger
Media pixel height.
- idstring
3402918475610233981
Media identifier.
- imagestring
https://cdninstagram.com/glacier-cover.jpg
Direct URL to the media image (highest resolution).
- mediaTypeinteger
2
Media type: 1 = image, 2 = video.
- paidPartnershipboolean
True when the item is tagged as a paid partnership.
- productTypestring
Instagram product type of the media, for example story.
- videoUrlstring
https://cdninstagram.com/glacier.mp4
Direct URL to the media video, when the item is a video.
- widthinteger
Media pixel width.
- foundboolean
true
True when the highlight was found; false when the lookup returned nothing.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Instagram Highlight detail API
The AnyAPI Instagram Highlight detail API returns Instagram highlight detail data as normalized JSON from one POST call to /v1/run/instagram.highlight_detail. Fetch the details and media items of a single Instagram story highlight by id. AnyAPI returns one normalized schema whichever source serves it. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.7% of Instagram highlight detail calls through AnyAPI succeeded, with a median response time of 2.0 seconds across 1,754 measured calls.
