Instagram Post Info
Instagram Post Info 记录描述单条公开帖子、Reel 或旧版 IGTV 内容，包括说明文字、作者身份、媒体引用、发布时间、可见互动指标和来源产品类型。这些字段可用于已知 URL 的信息补全、内容编目、互动快照和格式比较。
主要特性
- 直接查询内容 URL通过已知的 Instagram 公开 /p/、/reel/ 或 /tv/ URL 获取详情，无需采集主页内容或进行发现搜索。
- 说明文字与作者信息返回公开说明文字，以及可用的作者 ID、username、显示名称和头像引用。
- 媒体与互动详情标准化公开图片或视频引用，并返回可见的点赞、评论、观看和播放计数。
- 可追溯的标准记录在每条标准化帖子记录中保留提交 URL 和可用的来源产品类型。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的 Instagram 内容 URL，多个值用逗号或换行分隔。接受 instagram.com 和 www.instagram.com，路径必须以 /p/、/reel/ 或 /tv/ 开头。 |
如何使用
把公开内容 URL 作为异步任务提交，轮询 task ID，完成后通过 cursor 分页读取标准化记录。
- 准备一个或多个公开 instagram.com URL，路径以 /p/、/reel/ 或 /tv/ 开头，并包含内容 shortcode。
- 向 /v1/instagram/post-info POST urls。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 通过 /v1/tasks/{task_id}?limit=50 读取 data.results.items，并在 results.has_more 为 true 时继续传 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/instagram/post-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"urls\":[\"$INSTAGRAM_POST_URL\"]}"
# 轮询 GET /v1/tasks/{task_id}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results.items。最佳使用场景
- 已知帖子信息补全： 为已保存的 Instagram 内容 URL 补充说明文字、作者、媒体、发布时间和可见互动字段。
- 内容目录标准化： 把帖子、Reel 和旧版 IGTV 链接转换为结构一致的记录，并保留稳定身份与来源上下文。
- 公开互动快照： 记录指定内容在采集时返回的可见点赞、评论、观看和播放计数。
- 内容格式核对： 结合媒体字段和来源产品类型，比较已知 feed、Reel 与旧版 IGTV 内容的可用元数据。
使用建议
- 在 /p/、/reel/ 或 /tv/ 后提供真实 shortcode；只有路径前缀的 URL 可能通过格式校验，但不会返回记录。
- 处理多 URL 任务时保留 extra.input_url 以便回溯输入；重复 URL 会被合并，每个唯一 URL 最多产生一条记录。
- 结果数可能少于提交的 URL 数量；内容不可用或字段未公开时，应将作者、指标、媒体、时间和产品类型按可空字段处理。
相关 API
需要其他类型的 Instagram 公开数据时，可以使用以下 API。
- Instagram Followers Count API — 获取公开账号身份以及可见粉丝数、关注数和帖子数。
- Instagram Posts API — 按 username 采集公开帖子、媒体、标签、提及、时间和互动指标。
- Instagram Reels API — 按 username 采集公开 Reels、媒体、音频、标签、提及和互动指标。
- Instagram Search API — 按关键词或账号名称搜索公开主页及可见账号信息。
- Instagram Comments API — 从帖子 URL 采集公开评论、作者、时间、点赞数和回复数。
- Instagram Profiles API — 按 username 获取公开主页身份、简介、链接、账号标记、分类和可见计数。
- Instagram Followers List API — 采集公开粉丝资料记录，并保留来源账号和关注关系上下文。
- Instagram Following List API — 采集 Instagram 账号公开可见的关注主页，返回身份、关注关系上下文和可见账号计数。
- Instagram Hashtag Posts API — 按 hashtag 发现公开帖子，返回来源标签、媒体、创作者、时间和可见互动指标。
- Instagram Tagged Posts API — 按 username 采集标记指定主页的公开帖子，返回作者、媒体、提及、被标记用户上下文和互动指标。
- Instagram Transcript API — 从公开 Post 或 Reel URL 提取字幕文本、语言、格式、来源 URL 和 shortcode。
- Instagram Audio Reels API — 按已知数字 audio ID 采集公开 Reels，返回说明文字、创作者、媒体、时间、可见互动和来源音频上下文。
- Instagram Highlight Items API — 通过已知 highlight ID 获取保存的公开 Story 内容，返回文本、作者身份、媒体、时间、可见指标和来源上下文。
- Instagram Reels Search API — 按文本 query 搜索公开 Reels，返回说明文字、创作者、媒体、时间、可见互动指标和查询上下文。
- Instagram Story Highlights API — 按 username 列出公开快拍精选容器，返回标题、所属账号、媒体数量和可复用的 highlight ID。
- Instagram Trending Reels API — 采集趋势信息流当前展示的公开 Reel，返回说明文字、创作者、媒体、时间和可见互动指标。