# Instagram 推荐 Reels API (instagram.recommended_reels)

- Canonical page: [https://everyinfra.com/instagram-api/recommended_reels](https://everyinfra.com/instagram-api/recommended_reels?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "recommended_reels", "params": {...}}
- Price: $0.001181 per call ($1.18 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, one page of 10 per call (limit is ignored; pass the top-level next_page_token from the response as page_token for the next page)
- Pagination: pass next_page_token back as page_token for the next page, other params unchanged; one call per page, tokens last 24 hours
- 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=recommended_reels

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| page_token | not declared | no | not declared | 翻页令牌：把上一次响应里的 next_page_token 原样传回，拿下一页；不传是第一页。翻页时其他参数要和第一页一样。令牌 24 小时有效，每页算一次调用。没有 next_page_token 就是翻不下去了。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| post_id | 帖子短码，就是链接里 /p/ 或 /reel/ 后面那段（不是数字编号）。 |
| url | 该记录在原平台上的可访问链接。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| media_type | 取值只有两个：video（视频，Reels 也是 video）、image（图片；轮播帖也记作 image，有 product_type 时，product_type 为 carousel_container 的就是轮播）。 |
| like_count | 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。 |
| comment_count | 评论数。null 表示不公开，不等于 0。 |
| author_username | 作者用户名（@handle），通常可用于拼 URL。 |
| author_name | 作者昵称（显示名）。 |
| posted_at | 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。 |
| location | 地理位置描述，原文透传，格式随平台而异。 |
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| video_url | 视频文件链接：带声音的完整 mp4，能直接播放。轮播帖里有视频时是第一个视频；不是视频时不出现。链接带签名，会过期；有 video_url_expires_at 时以它为准。 |
| author_id | 作者在原平台的唯一 ID。 |
| width | 原图或原视频的宽，像素。 |
| height | 原图或原视频的高，像素。 |
| is_comments_disabled | 帖子是否关闭评论。 |
| author_follower_count | 作者粉丝数。null 表示不公开。 |
| hashtags | 正文里的话题标签数组，按出现顺序；没有时不出现这个字段。 |
| top_comments | 帖子下展示的几条评论，每项含正文（text）和评论人（author_username）；没有时不出现这个字段。 |
| product_type | Instagram 自己分的内容形态：feed 普通帖、clips Reels、carousel_container 轮播、longform 长视频。 |
| play_count | 播放量。 |
| fb_play_count | 作者把这条同时发到 Facebook 时，Facebook 那边的播放数；只有这样的帖子才出现。 |
| fb_like_count | 作者把这条同时发到 Facebook 时，Facebook 那边的点赞数；只有这样的帖子才出现。 |
| fb_comment_count | 作者把这条同时发到 Facebook 时，Facebook 那边的评论数；只有这样的帖子才出现。 |
| share_count | 分享/转发数。null 表示不公开，不等于 0。 |
| repost_count | 转发数（区别于引用转发）。null 表示不公开。 |
| duration_sec | 时长，秒。 |
| duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
| duration_estimated | 为 true 表示 duration_sec 是从视频链接里读出的整秒数，和精确时长最多差 1 秒。只在这样读出时出现。 |
| image_count | 图片张数：单图帖为 1；轮播帖是里面图片的张数，不算视频。 |
| video_count | 轮播帖里视频的个数；只有轮播帖有。 |
| video_url_expires_at | video_url 的过期时间，ISO 8601，UTC。 |
| video_hd_url | 清晰度最高的视频画面轨：只有画面、没有声音。会过期，过期时间见 video_hd_expires_at。要带声音的视频，把它和 audio_url 合成（比如用 ffmpeg 合并两条轨），或者直接用 video_url。 |
| video_hd_height | video_hd_url 的画面高度，像素。 |
| audio_url | 视频的音轨，只有声音；和 video_hd_url 差不多同时过期（见 video_hd_expires_at）。视频没有单独的音轨时（比如无声视频）不出现。 |
| video_hd_expires_at | video_hd_url 的过期时间，ISO 8601，UTC；audio_url 差不多同时过期。 |
| is_paid_partnership | 帖子是否标了「付费合作」（Paid partnership）。页面给了这项信息才出现，可能为 false。 |
| is_pinned | 是否置顶。帖子（user_posts、tagged_posts、recent_posts，以及 location_posts、audio_posts、explore 等返回帖子的接口）：被作者置顶在主页网格或 Reels 标签页，只在置顶时出现，值为 true。评论（comments）：被帖子作者置顶，只在置顶时出现，值为 true。精选（highlights）：是否被置顶在主页精选栏最前。 |
| likes_hidden | 作者隐藏了点赞数。只在隐藏时出现，值为 true；这时一般没有 like_count。 |
| caption_is_edited | 正文编辑过。只在编辑过时出现，值为 true。 |
| accessibility_caption | Instagram 自动生成的图片描述（替代文字，英文）。 |
| author_is_verified | 作者账号是否有认证标。出现在 user_posts、tagged_posts、location_posts、audio_posts、explore、stories、comment_replies，以及 post、discover、reels、hashtag、reels_search 的行里（有值才出现）。 |
| author_is_private | 作者是不是私密账号。 |
| author_avatar_url | 作者头像图片链接（多数平台带签名、会过期）。 |
| posted_at_estimated | 为 true 表示页面没给发布时间，posted_at 是按帖子的数字编号（id）推算出的上传时间；一般和发布时间相同，定时发布的帖子会早一些。只在推算时出现（tagged_posts 常见）。 |
| mentions | 正文里 @ 到的用户名，数组。 |
| tagged_users | 图片、视频里被标记的人的用户名，数组；轮播帖里每一张的都算。 |
| coauthors | 合著者：和作者一起署名发这条帖子的账号的用户名，数组。 |
| sponsors | 付费合作里标注的品牌方账号的用户名，数组。 |
| media | 轮播帖里的每一张，一张一项：type（image 或 video）、image_url（图片地址，视频是封面图；带签名，会过期）、video_url（只有视频有，带声音的 mp4）、width、height（像素）。只有轮播帖有。 |
| music | 帖子或 Reels 用的音乐，对象：歌手（artist）、曲名（title）；有的还带 audio_id（音乐编号）、is_original（true 是作者自己录的原声，false 是曲库里的歌）、is_explicit（曲库歌曲是否标了含露骨内容）、is_trending（原声是否正在流行，只有原声有）、url（Instagram 上这段音乐的页面）。原声的 title 一般是 Original audio，artist 是原声作者的用户名。没有时不出现这个字段。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| location_detail | 帖子挂的地点的详细信息，对象：id（地点编号）、name（地点名，和 location 相同）、short_name（短名）、city、address、lat、lng、url（Instagram 上这个地点的页面），有的才带。没挂地点时不出现。 |

## 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": "recommended_reels",
  "params": {}
}'
```

```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": "recommended_reels",
        "params": {},
    },
    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 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "instagram",
  "action": "recommended_reels",
  "results": [
    {
      "post_id": "Df004fGz-Ig",
      "url": "https://www.instagram.com/reel/Df004fGz-Ig/",
      "text": "🇰🇷弘大｜Odarijip 오다리집｜韓星都黎打卡嘅醬蟹老店🦀\n\n弘大必試生醃醬蟹，好多藝人都到訪嘅老牌專門店。\n\n店鋪位於大廈2‑3樓，空間闊落，座位疏落唔擠迫。牆上滿滿明星簽名同打卡相，充滿老店氛圍，燈光柔和，朋友聚餐、約會都合適，整體環境乾淨舒服。\n\n蟹肉滑溜似果凍，肉質飽滿扎實，入口釋放海鮮原生鮮甜，蟹殼內蟹膏滿溢，綿密油潤，鮮味濃郁。醬汁調配得啱啱好，唔會過重掩蓋蟹本身嘅風味。\n將蟹膏、蟹肉撈埋白飯，粒粒飯吸盡鮮香，真正體驗「偷飯賊」嘅威力。\n\n人氣👌高，飯市經常需要輪候，建議早啲到。弘大逛街行程可以bookmark！\n📍Odarijip 弘大…",
      "media_type": "video",
      "like_count": 1336,
      "comment_count": 29,
      "author_username": "y•••7",
      "author_name": "i•••y",
      "posted_at": "2026-11-17T02:15:30+00:00",
      "location": "香港",
      "id": "•••",
      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/905867834_1120715444164288_8231478405717265133_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=NDAzMjA4MDE0NjUxMjk5NDg0ODExMjA3MTU0Mzc0OTc2MjI%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX…",
      "video_url": "https://scontent-lax7-1.cdninstagram.com/o1/v/t2/f2/m86/AQOheRgHDZfLQyMWaSxdUyIfPMIkdGjWOxmBEWiGq1sPvcCfhiM2JzNNqor35cI_6Cd7akhRLuC0SR_nE2_jJ_feHKaTcTm5FI5Zjzo.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-lax7-1.cdninstagram.com&_nc_ohc=ICPFAqdR2-cQ7kNvwF8VIPn&efg=eyJ2ZW5jb2RlX…",
      "author_id": "•••",
      "width": 1080,
      "height": 1920,
      "is_comments_disabled": false,
      "hashtags": [
        "弘大美食",
        "Odarijip",
        "오다리집"
      ],
      "product_type": "clips",
      "share_count": 2638,
      "repost_count": 112,
      "duration_sec": 41,
      "duration_estimated": true,
      "video_url_expires_at": "2026-11-22T17:26:31+00:00",
      "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQMl_kNdQFW0sBrWxfCE0jgqZLDf0ANbBC-dBhKzbopXTuIx9QXzGk_HhiYguCsoxXwgUqV1LHUlBduGjeCQVQoiKbkhbUkVu09asjtl5lZvOQ.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=gLMVDeP-3aIQ7kNvwHLJFhE&efg=eyJ2Z…",
      "video_hd_height": 1920,
      "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQNarz1QtNu3JmbGzJrpMQToCXzibhqIsaPuedSxVb1T-IwU4L8A9jkwFby54hwGbJS79qopnmwk-0T1BaGDwADX5R02AWZLleoO61Q.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=gUNRu21NicEQ7kNvwHWjx-X&efg=eyJ2ZW5jb2RlX…",
      "video_hd_expires_at": "2026-11-25T15:21:26+00:00",
      "is_paid_partnership": false,
      "author_is_verified": true,
      "author_is_private": false,
      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",
      "music": {
        "artist": "yuny1117",
        "title": "Original audio",
        "audio_id": "29040011078996048",
        "is_original": true,
        "is_trending": false,
        "url": "https://www.instagram.com/reels/audio/29040011078996048/"
      },
      "platform": "instagram",
      "location_detail": {
        "id": "•••",
        "name": "香港",
        "url": "https://www.instagram.com/explore/locations/314055843/"
      },
      "duration_seconds": 41
    },
    {
      "post_id": "DeQLC8vB-XV",
      "url": "https://www.instagram.com/reel/DeQLC8vB-XV/",
      "text": "Running Into the Last Light 🐎🌅✨\nDJi drone makes it possible \nA herd of horses runs freely across the glowing green grassland as the horizon burns orange beneath a deep blue sky. With foals keeping pace beside them and endless open land ahead, this is what freedom looks like in mo…",
      "media_type": "video",
      "like_count": 511179,
      "comment_count": 1086,
      "author_username": "u•••n",
      "author_name": "U•••n",
      "posted_at": "2026-10-09T00:00:05+00:00",
      "id": "•••",
      "image_url": "https://scontent-lax3-2.cdninstagram.com/v/t51.82787-15/842492090_18635881834006763_6532142919362048035_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ig_cache_key=NDAwMzc0ODY0OTg5NjUwMjc0MTI3MTQ0Nzg5MjIyOTg1MTc%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2Rl…",
      "video_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM2_t64OHeUMHkiRrk_oXg1Fx13dHC8EsQn7qj4IoemJfIvUpgbG3jJW2XmbBs8bY50LXtPWvDOXmiZSLWZDp2wzEkz4BnWJxCfgVw.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=wZRSYNl-XEkQ7kNvwHmXjUk&efg=eyJ2ZW5jb2RlX…",
      "author_id": "•••",
      "width": 1080,
      "height": 1920,
      "is_comments_disabled": false,
      "hashtags": [
        "HorseHerd",
        "GrasslandLife",
        "skypixel"
      ],
      "product_type": "clips",
      "share_count": 60416,
      "repost_count": 18769,
      "duration_sec": 8,
      "duration_estimated": true,
      "video_url_expires_at": "2026-11-22T16:50:32+00:00",
      "video_hd_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m367/AQPN-g2dLkgxeaSoGKlyRAv2pWmGWM1UkRFftBDUO0jdVuUhnHdK8QcM3DCbtKs8ZnhTj1cCRrKGDsWmGRa8V4tXDKhL55Yxk0zd4Dg.mp4?_nc_cat=110&_nc_sid=9ca052&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=C84pV4KywUEQ7kNvwGt_uFU&efg=eyJ2ZW5jb2Rl…",
      "video_hd_height": 1920,
      "audio_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPDbrFss6LkseyEhe_bmqad9lEJ2BRsKkerSbbg58Yi-ojglE1qQF6hgNhDgLSOxrXDlWa3jQ9pVZZO7ri70bIitcJNpJAwkdyFhwg.mp4?_nc_cat=108&_nc_sid=9ca052&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=A1ZyzcC_ICQQ7kNvwEm4pbF&efg=eyJ2ZW5jb2RlX…",
      "video_hd_expires_at": "2026-11-25T18:23:31+00:00",
      "is_paid_partnership": false,
      "author_is_verified": true,
      "author_is_private": false,
      "author_avatar_url": "https://scontent-lax3-2.cdninstagram.com/•••",
      "music": {
        "artist": "usmanaryan",
        "title": "Original audio",
        "audio_id": "38684869254489915",
        "is_original": true,
        "is_trending": false,
        "url": "https://www.instagram.com/reels/audio/38684869254489915/"
      },
      "platform": "instagram",
      "duration_seconds": 8
    }
  ],
  "next_page_token": …,
  "pagination": { … },
  "count": 10,
  "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
