# Instagram Stories in a highlight API (instagram.highlight_stories)

- Canonical page: [https://everyinfra.com/en/instagram-api/highlight_stories](https://everyinfra.com/en/instagram-api/highlight_stories?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "highlight_stories", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, one page of 100 per target, no next_page_token (to read further, page one target at a time with the single-target action; limit is ignored)
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=instagram&action=highlight_stories

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| highlight_id | not declared | yes | not declared | The highlight ID: the `id` from `highlights` (a string of digits), or a highlight link https://www.instagram.com/stories/highlights/<id>/. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| media_url | platform-native meaning |
| media_type | Only two values: video (videos; Reels are also video) and image (images; carousel posts are also recorded as image, and when product_type is present, a product_type of carousel_container marks a carousel). |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| duration_sec | Duration, in seconds. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| author_avatar_url | Author avatar URL; signed link that expires. |
| author_is_verified | Whether the author's account has a verified badge. Appears in user_posts, tagged_posts, location_posts, audio_posts, explore, stories and comment_replies, and in post, discover, reels, hashtag and reels_search rows when it has a value. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| video_url | Video file URL: the complete mp4 with sound, playable directly. For a carousel post with videos, it is the first video; absent when the post is not a video. The link is signed and expires; when video_url_expires_at is present, go by it. |
| width | Width of the original image or video, in pixels. |
| height | Height of the original image or video, in pixels. |
| is_paid_partnership | Whether the post is marked "Paid partnership". Appears only when the page gives this information, and may be false. |
| links | (stories) Addresses of the link stickers on the story, as an array. |
| mentions | Usernames @-mentioned in the text, as an array. |
| hashtags | Hashtags in the text, in order of appearance; absent when there are none. |
| sponsors | Usernames of the brand accounts named in the paid partnership, as an array. |
| music | Music used by the post or Reel, as an object: artist and title; some also carry audio_id (music ID), is_original (true for original audio recorded by the author, false for a song from the music library), is_explicit (whether a library song is marked explicit), is_trending (whether original audio is trending; original audio only) and url (the Instagram page for this music). For original audio, title is usually Original audio and artist is the username of its author. Absent when there is no music. |
| author_id | Author's unique ID on the platform. |
| highlight_id | (highlight_stories) The ID of the highlight the story is in, the same on every row. |
| shared_post_url | (highlight_stories) The link of the post this story shares; absent on stories that share no post. |
| highlight_title | (highlight_stories) The highlight's title, the same on every row. |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "highlight_stories",
  "params": {
    "highlight_id": "18023864549864045"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "instagram",
        "action": "highlight_stories",
        "params": {
            "highlight_id": "18023864549864045",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-21T07:18:47Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 8. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "instagram",
  "action": "highlight_stories",
  "results": [
    {
      "id": "•••",
      "url": "https://www.instagram.com/stories/highlights/18023864549864045/",
      "media_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…",
      "media_type": "video",
      "duration_seconds": 9.943,
      "posted_at": "2026-10-20T13:14:30+00:00",
      "author_username": "n•••o",
      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",
      "author_is_verified": true,
      "platform": "instagram",
      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.71878-15/858981307_2584622395349397_7318871625928867813_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMjEyMDU2NzExNzM1NDYyNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnh…",
      "video_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…",
      "width": 720,
      "height": 1280,
      "is_paid_partnership": false,
      "links": [
        "https://www.nationalgeographic.com/travel/article/best-of-the-world-2027?cmpid=org%3Dngp%3A%3Amc%3Dsocial%3A%3Asrc%3Dinstagram%3A%3Acmp%3Deditorial%3A%3Aadd%3Digs20261020travel-bestoftheworld2027freemium&fbclid=PAZXh0bgNhZW0CMTEAcGRvZgJzcnRjBmFwcF9pZA85MzY2MTk3NDMzOTI0NTkAAacDA3R…"
      ],
      "author_id": "•••",
      "highlight_id": "18023864549864045",
      "shared_post_url": "https://www.instagram.com/p/Det5B-rAng2/",
      "highlight_title": "BOTW 2027",
      "duration_sec": 9.943
    },
    {
      "id": "•••",
      "url": "https://www.instagram.com/stories/highlights/18023864549864045/",
      "media_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…",
      "media_type": "video",
      "duration_seconds": 11.6,
      "posted_at": "2026-10-23T14:02:48+00:00",
      "author_username": "n•••o",
      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",
      "author_is_verified": true,
      "platform": "instagram",
      "image_url": "https://scontent-lax3-2.cdninstagram.com/v/t51.71878-15/864999986_1898267698207346_8225834360306799682_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDMxOTE4NjgyMTUzNTM4Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnh…",
      "video_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…",
      "width": 720,
      "height": 1280,
      "is_paid_partnership": false,
      "links": [
        "https://www.nationalgeographic.com/travel/article/best-of-the-world-2027?cmpid=org%3Dngp%3A%3Amc%3Dsocial%3A%3Asrc%3Dinstagram%3A%3Acmp%3Deditorial%3A%3Aadd%3Digs20261023travel-botw2027capecinematic1freemium&fbclid=PAZXh0bgNhZW0CMTEAcGRvZgJzcnRjBmFwcF9pZA85MzY2MTk3NDMzOTI0NTkAAad…"
      ],
      "author_id": "•••",
      "highlight_id": "18023864549864045",
      "highlight_title": "BOTW 2027",
      "duration_sec": 11.6
    }
  ],
  "count": 8,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=instagram
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
