instagram/
stories

输入公开账号的 username,即可拿到它此刻正在展示的全部快拍,包括图片或视频、发布时间、过期时间,以及快拍里的链接贴纸。

Instagram Stories API

Username 输入
在线快拍
链接贴纸
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Instagram Stories

Instagram 快拍是账号发出后只保留 24 小时的图片和视频,常用来发新品预告、限时优惠或带货链接,这些内容大多不会出现在主页帖子里。趁快拍还在线时把它们保存下来,品牌、运营和研究团队就能在快拍消失之后继续复盘这些活动。

Instagram Stories API 主要特性

  • 一次拿到账号的全部在线快拍提交一个 username,返回该账号在请求那一刻挂着的所有快拍。
  • 可直接存档的媒体每条快拍都带有图片或视频地址、宽高和封面图,方便保存或事后查看。
  • 什么时候发的,什么时候下线发布时间在 published_at,过期时间在 extra.expires_at,据此就能算好下一次采集的时间。
  • 链接和提及跟着快拍走链接贴纸指向的地址放在 extra.link_urls,被 @ 的账号放在 extra.mentions,都和所在的那条快拍对应。

Instagram Stories API 参数

参数必填描述
username必填要查看快拍的公开 Instagram 账号用户名,开头的 @ 可带可不带。

如何使用 Instagram Stories API

提交 username,等任务跑完,再从任务结果里读出快拍。

  1. 确定要查看的公开账号,例如 natgeo。
  2. 向 /v1/instagram/stories 发送 {"username": "natgeo"},记下返回的 task_id。
  3. 每隔几秒请求一次 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  4. 快拍在 results.items 里;results.has_more 为 true 时,带上 results.next_cursor 取下一页。
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"natgeo"}'

# 返回结果里有 task_id。
# status 变成 succeeded 后,GET /v1/tasks/{task_id} 会返回快拍。

Instagram Stories API 最佳使用场景

  • 每日快拍存档: 每天采集一到两次品牌账号的快拍,把媒体和发布时间存下来,快拍过期后也能回看。
  • 追踪促销动向: 盯住竞品快拍里的链接贴纸,看他们这一周主推哪些商品、活动和落地页。
  • 核对达人投放: 按投放要求比对达人快拍的发布时间、画面和链接,确认约定的快拍已经发出。

Instagram Stories API 使用建议

  • 两次采集的间隔控制在 24 小时以内,每条快拍在线期间都能至少被采到一次。
  • 需要长期保存的图片和视频请尽快下载,快拍的媒体链接是有时效的 CDN 地址。
  • 同一个账号重复采集时,用快拍 id 判断哪些已经存过。
  • 想要账号放在主页上的精选快拍,请用 Instagram Story Highlights 和 Instagram Highlight Items。

除了 Instagram Stories API,需要其他类型的 Instagram 公开数据时,可以使用以下 API。

  • Instagram Posts API — 按 username 采集公开帖子、媒体、标签、提及、时间和互动指标。
  • Instagram Reels API — 按 username 采集公开 Reels、媒体、音频、标签、提及和互动指标。
  • Instagram Profiles API — 按 username 获取公开主页身份、简介、链接、账号标记、分类和可见计数。
  • Instagram Tagged Posts API — 按 username 采集标记指定主页的公开帖子,返回作者、媒体、提及、被标记用户上下文和互动指标。
  • Instagram Story Highlights API — 按 username 列出公开快拍精选容器,返回标题、所属账号、媒体数量和可复用的 highlight ID。
  • Instagram Similar Accounts API — 按 username 列出 Instagram 推荐的相似账号,返回用户名、名称、头像和认证状态。

探索其他平台

还可以将 Instagram 数据与其他已支持社交平台的公开数据结合使用。

Instagram Stories API — 常见问题

Instagram Stories API 是一个用于按 username 获取公开 Instagram 账号当前在线快拍的 API。它返回每条快拍的 ID 和链接、图片或视频、封面图、作者和发布时间。

可以。提交公开账号的 username,快拍会以数据的形式返回,你这边不需要登录 Instagram。

带链接贴纸的快拍,会在这条快拍的 extra.link_urls 里返回贴纸指向的地址。

快拍在线 24 小时,每天采集一到两次,就能把每条快拍都采到。

任务会提示找不到该账号并结束,为这次请求预留的积分会退回你的余额。

每返回一条快拍收 0.5 积分;没有在线快拍的请求不收费。