Instagram User highlights API
List an Instagram account's story highlight reels by handle.
$1.20/1k req, pay per request, no subscription.
{"id": "17958812345098765","title": "Gear Guides","coverUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_highlight_gear.jpg","ownerHandle": "trailheadsupply","userId": "8821345600","avatarUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_profile.jpg","createdUtc": number | null,"mediaCount": integer | null}
Pricing and providers
Instagram User highlights API pricing: one API, 3 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Instagram user highlights in one request
This sample shows 9 of 12 fields. See every field
{
"found": true,
"data": {
"highlights": [
{
"id": "17958812345098765",
"title": "Gear Guides",
"coverUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_highlight_gear.jpg",
"ownerHandle": "trailheadsupply",
"userId": "8821345600",
"avatarUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_profile.jpg"
},
{
"id": "17958812345098890",
"title": "Trail Days",
"coverUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_highlight_trail.jpg",
"ownerHandle": "trailheadsupply",
"userId": "8821345600",
"avatarUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_profile.jpg"
},
{
"id": "17958812345099012",
"title": "Customer Fits",
"coverUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_highlight_fits.jpg",
"ownerHandle": "trailheadsupply",
"userId": "8821345600",
"avatarUrl": "https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_profile.jpg"
}
]
}
}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.
- handlestring
trailheadsupply
Instagram username without the leading @.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `mediaCount`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a highlight that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- userIdstring
Instagram numeric user id (optional, faster than handle).
Response
JSON, one example value per field.
Populated whenever the provider has data for the entity.
- avatarUrlstring
https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_profile.jpg
Profile picture URL of the account that owns the highlight.
- coverUrlstring
https://scontent.cdninstagram.com/v/t51.2885-19/trailheadsupply_highlight_gear.jpg
Populated whenever the provider has data for the entity.
- createdUtcnumbercan require
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Null when this source does not report it.
- idstring
17958812345098765
Populated whenever the provider has data for the entity.
- mediaCountintegercan require
Number of media items in the highlight. Null when this source does not report it.
- ownerHandlestring
trailheadsupply
Populated whenever the provider has data for the entity.
- titlestring
Gear Guides
Populated whenever the provider has data for the entity.
- userIdstring
8821345600
Instagram user id of the account that owns the highlight.
- foundboolean
true
- 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 User highlights API
The AnyAPI Instagram User highlights API returns Instagram user highlights data as normalized JSON from one POST call to /v1/run/instagram.user_highlights. List an Instagram account's story highlight reels by handle. AnyAPI routes each request across 3 sources and falls back automatically when one fails. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Instagram user highlights calls through AnyAPI succeeded, with a median response time of 7.0 seconds across 1,687 measured calls.
