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

> Returns the items within a specific Instagram story highlight including media URLs, timestamps, and interaction counts.

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/user/highlights`. |

## 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/user/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/user/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