# Instagram Highlight Detail API (https://www.socialcrawl.dev/platforms/instagram/highlight-detail)

> Returns the items within a specific Instagram story highlight including media URLs, thumbnails, durations, and capture timestamps. Highlights are archived story frames, so they carry no public caption and no public like, comment, or view count. Instagram shows story engagement only to the account owner, and it is never fabricated here.

TL;DR: `GET /v1/instagram/highlight/detail` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Instagram highlight ID: the numeric id, with or without the `highlight:` prefix. Get it from `/v1/instagram/highlights`. |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/instagram/highlight/detail" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get the stories inside an Instagram highlight?

Send a GET request to /v1/instagram/highlight/detail with the id parameter set to a highlight collection ID. SocialCrawl returns a JSON array of every story item in that highlight with media URLs, type, duration, and timestamp.

### Where do I get the highlight ID from?

Call the highlights endpoint first. /v1/instagram/highlights returns a list of highlight collections for a user, and each entry includes its highlight ID. Use that ID here to fetch the stories inside.

### What fields does the Highlight Detail API return?

Each story item includes a unique ID, media type (image or video), original media URL, thumbnail URL, duration (for videos), posted timestamp, and any music or sticker metadata Instagram exposes for that item.

### Can I download the media from highlight stories?

Yes. The response includes direct media URLs you can fetch with a regular HTTP client. Most stories stay available for as long as the user keeps the highlight pinned to their profile.

### How much does the Highlight Detail API cost?

One request costs 1 credit on the standard tier and returns every item in the highlight. With 100 free credits on signup you can pull around 100 highlight collections before deciding whether to upgrade.

See the full Instagram API: https://www.socialcrawl.dev/platforms/instagram

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to download every story inside one Instagram highlight
- Instagram API that returns full story items with media URLs