万有引擎
搜索⌘K
中文
登录免费开始

InstagramReels 短视频 API

看一个账号的 Reels 播放多少、多长、用了什么配乐：play_count、duration_sec、like_count、comment_count 一起返回，每千次 $1.19。

Instagram Reels 短视频按 username 列出一个公开账号发布的 Reels，每条带文案、时长、播放量、点赞和评论数、发布时间、地点、话题标签、封面图、视频链接和配乐。它回答「这个账号在做什么样的短视频、表现如何」，适合达人营销评估合作账号，社媒团队对照竞品的视频产出，以及研究短视频形式。

username 填账号的 handle，例如 nasa，不带 @。比较表现时，用 play_count 对照 like_count 和 comment_count，能看出哪些视频看的人多、互动也多。这项能力不返回字幕文本、热门评论和作者粉丝数。计数为 null 表示没有公开，不等于 0；duration_sec 单位是秒。

  • 一次最多 100 条
  • 同一个响应里返回结果
  • 不用登录 Instagram
免费开始

接口健康状态

24h 健康值
100%
24h 平均耗时
48.56 s
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
健康

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
{
  "platform": "instagram",
  "action": "reels",
  "params": {
    "username": "nasa"
  }
}

  2. 2JSON 响应

    {
  "results": [
    {
      "author_username": "",
      "post_id": "DfF3eqGSKKc",
      "text": "More power loading. 🔋\n\nToday, NASA astronaut Anil Menon and CSA (Canadian Space Agency) astronaut Joshua Kutryk conducted a spacewalk to install the 7th of 8 new roll out solar arrays. The final new array is slated to be installed during the Nov. 5 spacewalk, increasing the stati…",
      "media_type": "video"
    },
    …
  ],
  "count": 30
}

  3. 3表格行

    author_usernamepost_idtextmedia_type
    DfF3eqGSKKcMore power loading. 🔋 Today, NASA astronaut Anil Menon and CSA (Canadian Space Agency) astronaut Joshua Kutryk conducted a spacewalk to install the 7th of 8 new roll out solar arrays. The final new array is slated to be installed during the Nov. 5 spacewalk, increasing the stati…video
    De7XCa_TJ4hThis is how @nasa does game day. Roll Tide! 🚀🏈video

  4. 4CSV

    instagram-reels-sample.csv post_id,url,text,media_type,like_count,comment_count,author_username,author_name,posted_at,location,id,image_url,video_url,author_id,width,height,hashtags,play_count,duration_sec,duration_seconds,music,platform

请求带 username 和可选的 limit，JSON 响应里是这个账号的 Reels，含 play_count、duration_sec 和 music，再变成表格行和 CSV。

能拿到什么数据

表里是一次真实调用的结果：目标 nasa，2026年10月31日 16:50（UTC）采集，返回 30 条；灰条是隐去的个人信息（CSV 里是 •••）。你自己调用时，按字段表返回这些字段。

post_idurltextmedia_typelike_countcomment_countauthor_usernameauthor_nameposted_atlocationidimage_urlvideo_urlauthor_idwidthheighthashtagsplay_countduration_secduration_secondsmusicplatform
DfF3eqGSKKchttps://www.instagram.com/reel/DfF3eqGSKKc/More power loading. 🔋 Today, NASA astronaut Anil Menon and CSA (Canadian Space Agency) astronaut Joshua Kutryk conducted a spacewalk to install the 7th of 8 new roll out solar arrays. The final new array is slated to be installed during the Nov. 5 spacewalk, increasing the stati…video116091292026-10-29T20:35:35+00:00nullhttps://scontent-sof1-2.cdninstagram.com/v/t51.82787-15/865204930_18640535563026724_3353517023594775034_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAxODg2MjI0MTg0MzAyODYzNjE4NjQwNTM1NTYwMDI2NzI0.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwa…https://scontent-sof1-2.cdninstagram.com/o1/v/t2/f2/m86/AQMgO65IBSO4D1Fg1v8qWRLjCR7N-LaX4H_sPQeyoyjFQE149o094RWHdy1qn9GBy1VHAND2Io7UoTGpUBgIXE-YSbD4UnaCrO694xk.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-sof1-2.cdninstagram.com&_nc_ohc=koWnhp-eBvIQ7kNvwFJyYpR&efg=eyJ2ZW5jb2RlX…10801920null204393041.37599945068359441.375999450683594{"artist":"nasajohnson","title":"Original audio"}instagram
De7XCa_TJ4hhttps://www.instagram.com/reel/De7XCa_TJ4h/This is how @nasa does game day. Roll Tide! 🚀🏈video520122352026-10-25T18:35:11+00:00Bryant-Denny Stadiumhttps://scontent-sof1-2.cdninstagram.com/v/t51.82787-15/858088880_1909652077075572_3321833479248057878_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=101&ig_cache_key=NDAxNTkwNDgxNDIxODkxMTI2NTE5MDk2NTIwNzM3NDIyMzk%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLn…https://scontent-sof1-2.cdninstagram.com/o1/v/t2/f2/m86/AQO_XE-Eozfv9EhJgpBw8CpgqEydxrCcLTTmdJ4OmJL4u8TmjEREW4NyjX7EoxhsUiVfVbZseRJAIb1F9nUfjAsGTOK4bYFiS-v5fw4.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-sof1-2.cdninstagram.com&_nc_ohc=47tcWctX0mAQ7kNvwFwIIq6&efg=eyJ2ZW5jb2RlX…19161078null447427661.50799942016601661.507999420166016{"artist":"nasaadmin","title":"Original audio"}instagram
下载样例 CSV返回字段 ↓

用途

  • 评估合作账号

    读合作账号 Reels 的 play_count 和 like_count，判断视频的触达和互动。

  • 对标竞品视频

    取竞品账号的 Reels，用 duration_sec 和 text 看它们做多长、写什么文案。

  • 筛选高互动视频

    用 play_count 对照 comment_count，挑出播放高、互动也高的视频。

  • 统计常用配乐

    读 music 里的歌手和曲名，统计账号常用哪些配乐。

Instagram Graph API 与 EveryInfra 对比

下面从播放量、Reels 识别和访问条件三方面比 Instagram 官方 Graph API 和 EveryInfra reels。

对比项Instagram Graph APIEveryInfra
播放量字段 view_count："View count for Instagram Reels, which includes both paid and organic metrics."每行带 play_count，可以对照 like_count 和 comment_count。
识别 Reels字段 media_product_type："Surface where the media is published. Can be AD, FEED, STORY or REELS. Available for Instagram API with Facebook Login only."username 对应账号的 Reels，每行带 duration_sec 和 music。
访问条件"Note that a permission only allows access to data created by the app user who granted the permission."一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里，不用登录 Instagram，也不用 Instagram 访问令牌。

引文出自 Meta 开发者文档，2026-11-09 核对。 官方出处： IG Media (更新于 2026-10-29) · Instagram Platform overview (更新于 2026-10-29)

限制和注意事项

  • limit 是 1 到 100 的整数，默认 30；超出范围返回 422，不扣费。
  • 没有翻页参数，一次调用最多 100 条，可能少于 limit。
  • username 填不带 @ 的账号 handle，或完整主页链接。
  • 不返回字幕文本、热门评论和作者粉丝数。
  • play_count、like_count、comment_count 为 null 表示不公开，不等于 0；duration_sec 的单位是秒。
  • music 没有时整个字段不出现。

价格

每次调用 $0.001194，按次不按条，一次最多读 100 条。失败和空结果不收费。

调用次数费用
10,000$11.94
100,000$119.44
1,000,000$1,194.44

合计按每次调用的标价算。

代码示例

#
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": "reels",
  "params": {
    "username": "nasa"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

API 参考

下面是 reels 的参数、响应字段、错误和计费，可以复制整页，或用 Markdown 打开给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「InstagramReels 短视频」接口（instagram/reels）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 instagram，action 填 reels，参数放在 params 里。
- 必填参数：
  - username：Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据。
- 可选参数：
  - limit：这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 30）
- 返回一组记录，每条记录的主要字段：post_id（帖子 ID）、url、text、media_type（媒体类型（图/视频/轮播））、like_count、comment_count、author_username、author_name、posted_at、location、id、image_url；一共 21 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 示例请求体：
{
  "platform": "instagram",
  "action": "reels",
  "params": {
    "username": "nasa"
  }
}
- 计费：$1.19 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
platformbodystring是instagram平台标识，固定值。
actionbodystring是reels能力标识，固定值。
usernamebody.paramsstring是-Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据；followers 只查粉丝数量，followers_list/following_list 才查粉丝/关注账号列表。
limitbody.paramsinteger (1–100)否30这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。

响应示例

#
2026年10月31日 16:50（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息，列表只保留前 2 条；id、billing、quota 每次调用都不同，只给结构。
json
{  "id": "req_…",  "platform": "instagram",  "action": "reels",  "results": [    {      "post_id": "DfF3eqGSKKc",      "url": "https://www.instagram.com/reel/DfF3eqGSKKc/",      "text": "More power loading. 🔋\n\nToday, NASA astronaut Anil Menon and CSA (Canadian Space Agency) astronaut Joshua Kutryk conducted a spacewalk to install the 7th of 8 new roll out solar arrays. The final new array is slated to be installed during the Nov. 5 spacewalk, increasing the stati…",      "media_type": "video",      "like_count": 11609,      "comment_count": 129,      "author_username": "•••",      "author_name": "•••",      "posted_at": "2026-10-29T20:35:35+00:00",      "id": "•••",      "image_url": "https://scontent-sof1-2.cdninstagram.com/v/t51.82787-15/865204930_18640535563026724_3353517023594775034_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAxODg2MjI0MTg0MzAyODYzNjE4NjQwNTM1NTYwMDI2NzI0.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwa…",      "video_url": "https://scontent-sof1-2.cdninstagram.com/o1/v/t2/f2/m86/AQMgO65IBSO4D1Fg1v8qWRLjCR7N-LaX4H_sPQeyoyjFQE149o094RWHdy1qn9GBy1VHAND2Io7UoTGpUBgIXE-YSbD4UnaCrO694xk.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-sof1-2.cdninstagram.com&_nc_ohc=koWnhp-eBvIQ7kNvwFJyYpR&efg=eyJ2ZW5jb2RlX…",      "author_id": "•••",      "width": 1080,      "height": 1920,      "play_count": 2043930,      "duration_sec": 41.375999450683594,      "music": {        "artist": "nasajohnson",        "title": "Original audio"      },      "platform": "instagram",      "duration_seconds": 41.375999450683594    },    {      "post_id": "De7XCa_TJ4h",      "url": "https://www.instagram.com/reel/De7XCa_TJ4h/",      "text": "This is how @nasa does game day. Roll Tide! 🚀🏈",      "media_type": "video",      "like_count": 52012,      "comment_count": 235,      "author_username": "•••",      "author_name": "•••",      "posted_at": "2026-10-25T18:35:11+00:00",      "location": "Bryant-Denny Stadium",      "id": "•••",      "image_url": "https://scontent-sof1-2.cdninstagram.com/v/t51.82787-15/858088880_1909652077075572_3321833479248057878_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=101&ig_cache_key=NDAxNTkwNDgxNDIxODkxMTI2NTE5MDk2NTIwNzM3NDIyMzk%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLn…",      "video_url": "https://scontent-sof1-2.cdninstagram.com/o1/v/t2/f2/m86/AQO_XE-Eozfv9EhJgpBw8CpgqEydxrCcLTTmdJ4OmJL4u8TmjEREW4NyjX7EoxhsUiVfVbZseRJAIb1F9nUfjAsGTOK4bYFiS-v5fw4.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-sof1-2.cdninstagram.com&_nc_ohc=47tcWctX0mAQ7kNvwFwIIq6&efg=eyJ2ZW5jb2RlX…",      "author_id": "•••",      "width": 1916,      "height": 1078,      "play_count": 4474276,      "duration_sec": 61.507999420166016,      "music": {        "artist": "nasaadmin",        "title": "Original audio"      },      "platform": "instagram",      "duration_seconds": 61.507999420166016    }  ],  "count": 30,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。

字段含义
post_id帖子 ID。
url该记录在原平台上的可访问链接。
text正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
media_type媒体类型（图/视频/轮播）。
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保留平台原语义
author_id作者在原平台的唯一 ID。
width保留平台原语义
height保留平台原语义
hashtags正文里的话题标签数组，按出现顺序；没有时不出现这个字段。
play_count播放量。
duration_sec时长，秒。
duration_seconds时长，单位秒。非视频/音频内容为 null。
musicReels 使用的音乐，含歌手（artist）和曲名（title）；没有时不出现这个字段。
platform数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足，先充值。
422
参数名或取值不对，按错误信息给的候选改；不扣费。
429
超过每分钟请求上限，按 Retry-After 等待后再试。
503
暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果
没有数据，不扣费。

错误码

常见问题

能拿到 Reel 里说了什么吗？

这项能力不返回字幕文本。作者写的文案在 text，话题标签在 hashtags，可以用它们检索、统计或分类内容；存数时和 post_id、duration_sec 放在一起，便于比较不同时长视频的文案。

播放量看哪个字段？

play_count 是这条 Reel 的播放量，这项能力不另给浏览数。比较时一直用 play_count，对照 like_count、comment_count 看互动；play_count 为 null 的行先排除，null 表示没有公开，不代表没人看。

怎么读某条 Reel 下面的评论？

这项能力不带热门评论。把这一行的 url 传给 Instagram 评论，它接受单个帖子或 Reel 链接，返回这条内容下的评论。账号本身的资料和粉丝数，用同一个 handle 调 Instagram 主页或对象详情。

Instagram Reels API 能拿到什么数据？

按 username 返回该账号的 Reels：text、play_count、duration_sec、like_count、music 和 video_url。

一次最多取多少条，怎么翻页？

limit 取 1 到 100，默认 30，一次最多 100 条，可能少于 limit。没有翻页参数。

取 Reels 要花多少钱？

每千次调用 $1.19，每次 $0.001194，按次不按条。失败和空结果不收费。

取 Reels 要登录 Instagram 吗？

不用。请求头里放一把 EveryInfra API Key（Authorization: Bearer），不需要 Instagram 登录，也不需要 Instagram 访问令牌。

reels 和 reels_search 有什么区别？

reels 按账号 username 取 Reels，带 music。reels_search 按 keyword 找词下的 Reels，带 is_verified，没有 music。

相关的 Instagram 能力

同一把 Key 还能调 Instagram 的其他能力，比如读 Reel 下面的评论，或按关键词搜 Reels。

自有访问统计常开；Google Analytics 仅在你点「同意分析」后启用。 隐私政策