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 — or from Instagram's web UI when the list endpoint is login-gated — and get the album's items as clean JSON: type (image | video), url, thumbnailUrl, takenAt, dimensions, durationSeconds on videos, plus coverUrl and title. Flat 1 credit. Pass cache=true for the 24h shared cache.
What you get
- Per-item media URLs + takenAt
- Video duration when applicable
- coverUrl + title + itemCount
- Flat 1 credit
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), or from Instagram's web UI when the list endpoint is login-gated. This endpoint cannot invent an id — when the list is down, details is down unless you already have one.
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.