Instagram Highlights Details API
Items inside one Instagram Story Highlight album — media URLs, type, takenAt. Flat 1 credit.
GET request to /v1/instagram/highlights-details that responds with clean JSON and costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.What is the Instagram Highlights Details API?
Pass a highlight id from /v1/instagram/highlights (with or without the highlight: prefix) — or from Instagram's web UI — and get the album's items as clean JSON: type (image | video), url, thumbnailUrl, takenAt, dimensions, durationSeconds on videos, plus coverUrl and title. An id we could not resolve is 404 HIGHLIGHT_NOT_FOUND (retryable false). A login wall / timeout / block is 503 HIGHLIGHT_UNAVAILABLE (retryable true, Retry-After). Both bill 0 credits. Two empty Instagram JSON replies fail fast — a miss is not a 10s wait. Flat 1 credit on a hit. Pass cache=true for the 24h shared cache.
What you get
- Per-item media URLs + takenAt
- HIGHLIGHT_NOT_FOUND (404) vs HIGHLIGHT_UNAVAILABLE (503, retryable)
- Fail-fast miss instead of a 6–17s 404
- Flat 1 credit on a hit; 4xx/5xx do not bill
Try it
Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).
Parameters
curl "https://api.captapi.com/v1/instagram/highlights-details?id=highlight%3A18201653992314974" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"data": {
"id": "dQw4w9WgXcQ",
"title": "Example video",
"author": "@creator",
"views": 1842203,
"likes": 95210,
"comments": 4123,
"durationSec": 213,
"publishedAt": "2024-11-02T10:00:00Z"
}
}Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success and a data object with the following fields:
Video
idStable platform ID for the video.titleVideo title.authorCreator handle or channel name.durationSecVideo length in seconds.publishedAtPublish date (ISO 8601).
Engagement
viewsTotal view count.likesTotal like count.commentsTotal comment count.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Highlight id from /v1/instagram/highlights (with or without highlight: prefix). |
| cache | boolean | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.
instagram_highlights_details via @captapi/mcp. Set it up →How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/instagram/highlights-detailsand parse the JSON response.
Use cases
Analytics
Track views, likes, and engagement over time.
Competitor Monitoring
Benchmark the performance of other creators.
Dashboards
Power reporting and BI with real metadata.
Content Curation
Filter and rank videos by performance.
Frequently asked questions
What does the Instagram Highlights Details API do?+
The Instagram Highlights Details API lets you fetch full metadata and key stats from a public Instagram highlight details using one GET request to /v1/instagram/highlights-details. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the Instagram Highlights Details API cost?+
Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a Instagram API key or OAuth?+
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.
Where do I get the highlight id?+
From /v1/instagram/highlights (highlights[].id) on a full shelf, or from Instagram's web UI. This endpoint cannot invent an id — when the list is 503, details has nothing to dereference unless you already have an id.
Why is this 404 vs 503?+
HIGHLIGHT_NOT_FOUND (404, retryable false) means this highlight id could not be resolved. HIGHLIGHT_UNAVAILABLE (503, retryable true, Retry-After header) means we could not reach Instagram (login wall, rate, timeout) — the album may still exist. Both bill 0 credits. A miss fails after two empty JSON replies, not a 10s ladder.
Is the Instagram Highlights Details API suitable for production use?+
Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
More Instagram APIs
Ready to use the Instagram Highlights Details API?
Sign up, grab your key, and make your first call in 60 seconds.