Instagram Comments API

Instagram Comments

主要特性

• 多帖子评论采集在一次请求中采集一个或多个 Instagram 公开帖子 URL 下的评论。
• 标准化评论记录以一致结构返回评论 ID、文本、作者身份、发布时间、采集时间和来源 URL。
• 可见讨论指标通过标准化 metrics 字段返回公开点赞数和回复数，便于比较讨论活跃度。
• 可追溯的对话上下文保留帖子、父评论和输入 URL 引用，便于关联数据、去重和分析评论关系。
• 公开数据边界结果不包含私密、受限、已删除或登录后才可见的评论。

参数

如何使用

把公开 Instagram Post URL 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化评论记录。

1. 准备一个或多个公开 Instagram Post URL。
2. 向 /v1/instagram/comments POST urls。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /v1/tasks/{task_id}?limit=50 读取 data.results，有更多记录时继续传 results.next_cursor。

curl -X POST "https://api.socq.ai/v1/instagram/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/p/POST_CODE/"]}'

# 轮询 GET /v1/tasks/{task_id}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results。

最佳使用场景

• 消费者情绪监测： 分析公开评论文本、Emoji 和可见互动信号，追踪受众对选定 Post 的反应。
• 趋势与机会发现： 从公开讨论中发现新兴话题、产品反馈、功能诉求、重复问题和早期需求信号。
• 活动反馈分析： 使用一致的评论记录，对比不同活动 Post、创意、发布或公告下的公开反应。
• 品牌与口碑监测： 跟踪选定公开 Post 下的正面反馈、投诉、重复关注点和受众态度变化。
• 竞品与达人研究： 研究竞品和达人公开 Post 下的讨论，对比话题、问题和可见互动表现。
• 活跃受众发现： 利用公开作者信息、评论点赞和回复计数，识别推动讨论的评论和参与者。
• 分析与数据管道： 把标准化评论记录接入文本分析、报表、Dashboard 或数仓流程。

使用建议

• 提交需要分析的标准 Instagram Post URL。
• 先使用小批量 URL 验证覆盖情况，再逐步增加提交的帖子数量。
• 保存返回的 task_id；登录状态或网络中断后恢复轮询原任务，不要重复提交。
• 任务成功后持续传 results.next_cursor，直到 has_more 为 false，不要假设第一页包含全部结果。
• 保存 comment id、post_id、post_url、parent_comment_id 和 input_url，以便可靠关联和去重。
• 围绕 comment id、text、author、created_at、collected_at 和来源引用设计下游 schema，再用 media 与 metrics 扩展分析维度。
• 使用 replies_count 排序活跃讨论，并通过 parent_comment_id 保留评论关系。
• 遇到临时错误时使用有上限的指数 backoff，429 响应包含 retry-after 时应优先遵循。
• 渲染评论或送入自动分析流程前，先校验并转义评论文本。
• 需要父 Post 的文本、media、发布时间或 Post 级互动数据时，配合 Posts API 使用。

相关 API