Facebook Comment Replies
Facebook Comment Replies 是已知评论下的公开回应，包含回复文本、作者标识、可见互动、时间和父级 feedback 上下文。这些记录可用于还原对话分支、分析回应内容并监测回复层级的变化。
主要特性
- 由 token 定位回复范围使用成对的 feedback_id 和 expansion_token，获取一条已知 Facebook 评论下的公开回复分支。
- 标准化回复上下文以一致结构返回回复 ID、URL、文本、作者 ID 与名称、可见互动、时间以及父级 feedback ID。
- 有边界的 cursor 采集沿回复 cursor 继续读取并按评论 ID 去重，在达到请求数量、分支结束或采集页数上限时停止。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
feedback_id | 必填 | 已知父评论的必填 feedback 标识。 |
expansion_token | 必填 | 与同一父评论配对的必填回复 expansion token。 |
results_limit | 可选 | 最多采集 20 至 2,000 条回复，默认值为 100。 |
如何使用
把已知 Facebook 评论的 token 对作为异步任务提交，轮询 task ID，完成后再用结果 cursor 分页读取标准化回复记录。
- 从同一条兼容的 Facebook Comments 结果中读取 extra.feedback_id 和 extra.expansion_token。
- 向 /v1/facebook/comment-replies POST feedback_id、expansion_token，以及可选的 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded。
- 通过 /v1/tasks/{task_id}?limit=50 读取结果，有更多已保存记录时继续传入 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/facebook/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"feedback_id":"feedback_123","expansion_token":"reply_token","results_limit":100}'
# 轮询 GET /v1/tasks/{task_id}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results。最佳使用场景
- 还原评论分支： 结合回复 ID 和 extra.parent_feedback_id，重建选定评论下的公开回应分支。
- 回复层级的回应分析： 利用回复文本、作者标识、时间和可见互动，研究对话中用户如何回应。
- 对话监测与报告： 跟踪选定父评论下的标准化回复记录，并比较不同采集批次的回复活动。
使用建议
- 从同一条 Facebook Comments 记录取得 feedback_id 和 expansion_token，因为任意帖子或评论 URL 都不能替代这组 token。
- 对于较长的回复分支，应明确设置 results_limit；采集会在达到该数量、分支结束或 100 个回复分页后停止。
- 合并多次采集结果时，结合回复 id 与 extra.parent_feedback_id 去重，确保相同回复 ID 仍关联正确的父评论。
- 把 url、text、作者字段、可见指标和 created_at 视为可选值，并按不可信用户内容安全处理回复文本。
相关 API
需要其他类型的 Facebook 公开数据时，可以使用以下 API。
- Facebook Pages API — 获取公开 Page 资料、联系方式、图片和可见受众评分。
- Facebook Posts API — 从受支持的 Facebook URL 采集公开帖子、媒体、表情回应、评论数和分享数。
- Facebook Comments API — 从帖子 URL 采集公开评论、作者、互动、媒体和来源链接。
- Facebook Video Transcript API — 从已知的公开视频帖子或 Reel URL 提取可用字幕文本和格式。
- Facebook Group Posts API — 从 Facebook 群组 URL 采集公开帖子，可选择排序并设置每个群组的数量上限，返回作者、视频媒体和可见互动信息。
- Facebook Events Search API — 按关键词搜索公开活动，返回日程、地点、出席指标、封面媒体和活动状态字段。
- Facebook Ad Transcript API — 从 Facebook Ad Library URL 提取可用口播文本、语言、格式和来源上下文。
- Facebook Company Reviews API — 采集公开 Page 评价，返回评价文本、评价者链接、评分、点赞数、时间和公司上下文。
- Facebook Event Details API — 通过已知公开活动 URL 采集标准化元数据、日程、地点、媒体和可见互动指标。
- Facebook Profile Events API — 从个人资料或 Page URL 采集关联的公开活动，返回名称、日程、地点、媒体、可见指标和来源上下文。
- Facebook Profile Photos API — 从个人资料或 Page URL 采集公开照片，返回说明文字、作者上下文、互动指标、图片元数据和来源引用。
- Facebook Profiles API — 通过已知 Facebook URL 查询公开个人资料或主页，返回身份信息、简介、头像、可见计数和输入上下文。
- Facebook Reels API — 从个人资料或 Page URL 采集公开 Reels，返回说明文字、作者上下文、视频元数据、可见互动和来源引用。