Instagram Highlight detail API
To get a story highlight with every story in it from Instagram, call GET /v1/instagram/user/highlight/detail?id=… with your API key. You get clean JSON back.
/v1/instagram/user/highlight/detailcurl "https://api.scraperize.com/v1/instagram/user/highlight/detail?id=17975319242920589" \ -H "x-api-key: YOUR_API_KEY"
cache_max_age to reuse a recent result for free.429 with a Retry-After header.Parameters
idRequired17975319242920589 (the id from /v1/instagram/user/highlights; a /stories/highlights/<id>/ URL also works).cache_max_ageOptionalmeta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.Send your key in the x-api-key header. Full API reference
Example response
{
"data": {
"highlight": {
"id": "17975319242920589",
"title": "Just Do It",
"url": "https://www.instagram.com/stories/highlights/17975319242920589/",
"coverUrl": "https://scontent-los4-1.cdninstagram.com/v/t51.71878-15/544818894_2419507208428757_4822384952945732927_n.jpg?stp=dst-jpg…",
"latestStoryAt": "2025-09-19T16:48:25.000Z",
"storyCount": 48,
"storiesAvailable": true,
"canReshare": true,
"owner": {
"id": "13460080",
"handle": "nike",
"fullName": null,
"isVerified": true,
"profilePicUrl": "https://scontent-los4-1.cdninstagram.com/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jp…",
"url": "https://www.instagram.com/nike/",
"isPrivate": false,
"transparencyLabel": null,
"aiLabel": null
}
},
"stories": [
{
"id": "3713636227774800082",
"code": "DOJfHk1ieDS",
"mediaType": "video",
"takenAt": "2025-09-03T17:19:17.000Z",
"expiredAt": "2025-09-04T17:19:17.000Z",
"width": 1080,
"height": 1920,
"imageUrl": "https://scontent-los4-1.cdninstagram.com/v/t51.71878-15/542276903_2085294435612351_6356133177611658319_n.jpg?stp=dst-jpg…",
"videoUrl": "https://scontent-los4-1.cdninstagram.com/o1/v/t2/f2/m78/AQNTsJfd6gqlJnxcA6qz1CR4cX-0IhuMWJymr62cDBFFLIYVhmUbM32DIsZoOo0U…",
"videoVersions": [
{
"type": 101,
"url": "https://scontent-los4-1.cdninstagram.com/o1/v/t2/f2/m78/AQNTsJfd6gqlJnxcA6qz1CR4cX-0IhuMWJymr62cDBFFLIYVhmUbM32DIsZoOo0U…",
"width": null,
"height": null
}
],
"videoDurationSeconds": 9.8,
"hasAudio": true,
"caption": null,
"accessibilityCaption": null,
"isPaidPartnership": false,
"isEdited": false,
"aiLabel": null,
"links": [],
"hashtags": [],
"mentions": [],
"locationIds": [],
"sharedPosts": [],
"music": [],
"ctaLinks": [],
"sponsors": [],
"resharedFrom": null,
"appAttribution": null,
"capturedWith": null
}
],
"count": 48,
"fetchedAt": "2026-10-12T15:30:06.501Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}A real response, shortened to one item per list.
Instagram Highlight detail API questions
How much does the Instagram Highlight detail API cost?
1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.
Do I need a Instagram account or API key?
No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Instagram login or developer app is needed.
How fresh is the data?
Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.
Where are the full parameters and response fields?
In the API reference, with every parameter, field and error.