POST /v1/instagram/highlightsInstagram Story Highlights Scraper API
Story highlights of an Instagram profile: up to 10 per account with ID, title, cropped cover image and link.
- Cost
- 1 credit
- Blocks and errors
- Refunded
- Cache hits
- Free
- Response fields
- 6
- Limits
- Up to 10 highlights · cropped covers onlyAll limits
Updated · Maintained by the Scrape Everything team
What the Instagram Story Highlights Scraper API does
The Instagram Story Highlights API returns the highlights tray of a public Instagram profile, the row of circles under the bio. You get up to 10 highlights in profile order, each with its ID, title, a 150x150 cropped cover image and the highlight link, plus the account's username, user ID and privacy flag. Send a username, an @handle or a profile URL. The stories inside a highlight are not returned, and opening the link on Instagram needs a login. Full-size covers are not available either, so cover_url_full is always null. has_more tells you when the account has more than the 10 highlights shown. Each request costs 1 credit.
What you get
Top-level fields of the response. Every field is typed and documented; nullable fields are null when the platform does not show them.
| Field | Type | Description |
|---|---|---|
username | string | Instagram username |
user_id | string | null | Instagram numeric user ID |
is_private | boolean | Account is private (its highlights are not visible: empty list) |
highlights | array<object> (5 fields each) | Highlights in profile order, at most 10 |
highlights_returned | integer | Number of highlights returned |
has_more | boolean | The account has more highlights than the ones returned |
Request example
Send the API key as a Bearer token. The body is a small JSON object.
curl -X POST https://api.scrapeeverything.com/v1/instagram/highlights \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"nasa"}'| Parameter | Required | Description |
|---|---|---|
username | Yes | Instagram username, @handle or profile URL. |
Response example
A real response from the live API, captured on November 12, 2026 for the request above. Lists are cut to two items and long links and texts are shortened.
{
"success": true,
"data": {
"username": "nasa",
"user_id": "528817151",
"is_private": false,
"highlights": [
{
"id": "18145966027591735",
"title": "MAX POWER",
"cover_url": "https://scontent.cdninstagram.com/v/t58.9792-6/892543954_2745207605911193_3609967545310090114_n.jpg?…",
"cover_url_full": null,
"link": "https://www.instagram.com/stories/highlights/18145966027591735/"
},
{
"id": "18195781759377100",
"title": "Roman",
"cover_url": "https://scontent.cdninstagram.com/v/t51.71878-15/785745361_1537318174532484_931463605431094788_n.jpg?…",
"cover_url_full": null,
"link": "https://www.instagram.com/stories/highlights/18195781759377100/"
}
],
"highlights_returned": 6,
"has_more": false
},
"meta": {
"request_id": "req_91g0wGPhl2s6xbZN5rcH",
"scraper": "instagram.highlights",
"cached": false,
"cached_at": null,
"cache_age_seconds": null,
"credits_charged": 1,
"credits_remaining": 99,
"duration_ms": 4148
}
}Empty in this capture: highlights[].cover_url_full. A null field means the value was not available for this request.
Try it with your own input: open this endpoint in the playground with your 100 free credits. Errors use the same envelope with success: false and a documented code; which of them are billed is answered below.
How much does the Instagram Story Highlights Scraper API cost?
Each request costs 1 credit, so 1,000 requests use 1,000 credits. You are charged only when a request returns data or a definitive answer. Credits come in one-time packs that never expire; the cards below show what 1,000 requests cost with each pack. New accounts get 100 free credits.
Builder pack
$0.80
25,000 credits for $19.99
Growth pack
$0.60
500,000 credits for $299.00
Scale pack
$0.50
1,200,000 credits for $599.00
See pricing for all packs and rate limits.
Which requests are billed and which are refunded?
A request is billed (1 credit) when it returns data or a definitive answer. A 404 with a code such as NOT_FOUND or PRIVATE_ACCOUNT means the target is missing or not public, so drop it from your list instead of retrying. Blocks, timeouts and errors on our side are refunded automatically, and invalid requests are never charged.
- Billing: 1 credit per request. A private account returns 200 with is_private: true and an empty list, a completed answer that is billed. 404 NOT_FOUND and AGE_RESTRICTED are billed too. If Instagram does not return the tray, the call fails and the credit is refunded.
- title is an empty string for an untitled highlight, and owners can rename highlights, so match snapshots by id.
- cover_url is the 150x150 crop Instagram shows on the profile; cover_url_full is always null.
- Caching: with cache_days (1 to 14) a repeat request for the same username is free and returns the tray as it was when it was fetched.
Every billed and refunded case is listed under credits and billing and errors.
Use cases
- Audit how brands organize their profile: highlight titles often name products, reviews, FAQs or store locations.
- Notice when a competitor adds, renames or removes a highlight by comparing IDs and titles between snapshots.
- Show a creator's highlight titles and covers in a vetting report or media kit.
What are the limits of the Instagram Story Highlights Scraper API?
Each request looks up one target, given as username. New accounts can send 60 requests a minute, rising to 300 a minute once your purchases total $19.99 or more. Every endpoint returns public data only, never private or login-only content; the limitations and notes below list what this one leaves out.
Limitations: Unofficial API: not affiliated with or endorsed by the platform. Public data only. Private accounts return profile fields only; posts show at most 15 newest comments; highlights come with titles and covers, not the stories inside; like and comment counts in the posts list are often null (the single post endpoint returns them), and the link in bio can be null.
- Up to 10 highlights are returned, with no pagination. has_more tells you the account has more.
- Covers are cropped 150x150 thumbnails; full-size covers are not available (cover_url_full is always null). The stories inside a highlight are not included.
- Private accounts return an empty list with is_private true. Missing and age-restricted accounts return 404 (code AGE_RESTRICTED for the latter).
Need more than that? Rate limits explains the per-minute and concurrency limits, or contact us for higher limits.
Questions
Can I download the stories inside a highlight?
No. The stories and their photos or videos are not in the response. Highlight contents are not public, and this API returns public data only.
Why are at most 10 highlights returned?
Only the first 10 highlights of a profile are available, with no pagination. has_more is true when the account has more than those 10.
How is this different from the Instagram profile endpoint?
The profile endpoint tells you whether an account has highlights (has_highlights) and, when known, how many (highlight_count). This endpoint adds each highlight's ID, title, cover and link.
Can I re-read a result without paying again?
Yes. Send cache_days (1 to 14) and a repeat request for the same target within that window is served from your cache for free.
Use the Instagram Story Highlights Scraper API without code
Open this endpoint in the dashboard playground, switch to Multi and paste up to 500 username values, one per line. Each line runs as one request (1 credit) and the results download as CSV or JSON. In n8n, Make, Zapier or Google Sheets, send the same request from a workflow or a sheet.
Instagram guides and API reference
More Instagram endpoints
- Instagram Profile Scraper API
- Instagram Posts Scraper API
- Instagram Post Scraper API
- Instagram Reel Scraper API
- Instagram Comments Scraper API
- Instagram Reels Scraper API
- Instagram Reels Search Scraper API
- Instagram Profile Search Scraper API
- Instagram Post Count Scraper API
- Instagram Trending Reels Scraper API
Start with 100 free credits.
Continue with Google, create an API key and send your first request in under a minute.