# Instagram 精选合集里的快拍 API (instagram.highlight_stories)

- Canonical page: [https://everyinfra.com/instagram-api/highlight_stories](https://everyinfra.com/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 | 精选合集的编号：highlights 结果里的 id（一串数字），直接给合集链接（https://www.instagram.com/stories/highlights/<编号>/）也行。一次给全这个合集里的快拍，最多 100 条，不分页。合集不存在、已删除，或合集所属账号是私密账号时返回空结果，不扣费。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| media_url | 快拍的图片或视频直链（stories）。链接带签名，几小时后失效，要尽快下载。 |
| media_type | 取值只有两个：video（视频，Reels 也是 video）、image（图片；轮播帖也记作 image，有 product_type 时，product_type 为 carousel_container 的就是轮播）。 |
| duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
| duration_sec | 时长，秒。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| author_username | 作者用户名（@handle），通常可用于拼 URL。 |
| author_name | 作者昵称（显示名）。 |
| author_avatar_url | 作者头像图片链接（多数平台带签名、会过期）。 |
| author_is_verified | 作者账号是否有认证标。出现在 user_posts、tagged_posts、location_posts、audio_posts、explore、stories、comment_replies，以及 post、discover、reels、hashtag、reels_search 的行里（有值才出现）。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| video_url | 视频文件链接：带声音的完整 mp4，能直接播放。轮播帖里有视频时是第一个视频；不是视频时不出现。链接带签名，会过期；有 video_url_expires_at 时以它为准。 |
| width | 原图或原视频的宽，像素。 |
| height | 原图或原视频的高，像素。 |
| is_paid_partnership | 帖子是否标了「付费合作」（Paid partnership）。页面给了这项信息才出现，可能为 false。 |
| links | （stories）快拍上链接贴纸的地址，数组。 |
| mentions | 正文里 @ 到的用户名，数组。 |
| hashtags | 正文里的话题标签数组，按出现顺序；没有时不出现这个字段。 |
| sponsors | 付费合作里标注的品牌方账号的用户名，数组。 |
| music | 帖子或 Reels 用的音乐，对象：歌手（artist）、曲名（title）；有的还带 audio_id（音乐编号）、is_original（true 是作者自己录的原声，false 是曲库里的歌）、is_explicit（曲库歌曲是否标了含露骨内容）、is_trending（原声是否正在流行，只有原声有）、url（Instagram 上这段音乐的页面）。原声的 title 一般是 Original audio，artist 是原声作者的用户名。没有时不出现这个字段。 |
| author_id | 作者在原平台的唯一 ID。 |
| highlight_id | （highlight_stories）这条快拍所在的精选合集的编号，每行相同。 |
| shared_post_url | （highlight_stories）这条快拍转发的帖子的链接；不是转发帖子的快拍没有这一项。 |
| highlight_title | （highlight_stories）精选合集的标题，每行相同。 |

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