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,等任务跑完,再从任务结果里读出快拍。
- 确定要查看的公开账号,例如 natgeo。
- 向 /v1/instagram/stories 发送 {"username": "natgeo"},记下返回的 task_id。
- 每隔几秒请求一次 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 快拍在 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。
相关 API
除了 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 Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API