Facebook Company Reviews
Facebook Company Reviews 是 Page 上公开展示的推荐或评分，包含文字反馈、评价者身份、发布时间、可见点赞数和公司层面的评价信号。这些记录可用于反馈研究、口碑快照、评价者上下文分析，以及已知 Page 之间的比较。
主要特性
- 按 Page 评价 URL 采集接收一个或多个受支持的 Facebook Page /reviews URL，并采集各输入对应的公开评价记录。
- 评价与评价者记录以标准化结构返回评价 ID、来源 URL、文本、评价者姓名与主页链接、可见点赞数、评分值和发布时间。
- 公司层面上下文在单条评价旁保留公司名称、Page URL、综合评分和评价总数，便于比较不同来源。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | facebook.com、www.facebook.com 或 m.facebook.com 上路径包含 /reviews 的 Facebook Page 评价 URL，多个值使用逗号或换行分隔。 |
results_limit | 可选 | 每个输入 URL 请求的评价数量上限，可填写 20 到 2,000 的整数；默认值为 100，实际公开结果可能更少。 |
如何使用
把 Facebook Page /reviews URL 作为异步任务提交，轮询 task ID，完成后再用 cursor 分页读取标准化评价记录。
- 准备一个或多个路径中包含 /reviews 的 Facebook Page 公开 URL。
- 向 /v1/facebook/company-reviews POST urls，并按需设置 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded。
- 读取 /v1/tasks/{task_id}?limit=50；当 results.has_more 为 true 时，把 results.next_cursor 作为 cursor 继续请求。
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'
# 轮询 GET /v1/tasks/{task_id}，再请求
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}。最佳使用场景
- 反馈数据集整理： 结合评价文本、评分值、发布时间和来源 URL，为后续话题或情感分析准备公开反馈数据集。
- 口碑快照报告： 把单条评价评分与公司综合评分、评价总数结合，记录所选 Page 在采集时的公开评价状态。
- 评价者互动研究： 使用评价者姓名、主页链接和可见点赞数，研究哪些用户提供了公开反馈，以及哪些评价获得互动。
使用建议
- 使用能够访问的 Facebook Page /reviews URL，不要用公司名称或普通 Page URL 代替。
- 根据所需深度为每个输入 URL 设置 results_limit；当 Facebook 公开的评价历史较少时，应预期返回数量低于上限。
- 每个 Page URL 只提交一次，因为采集前会移除重复输入。
- 当 Facebook 未公开某个值时，应允许评价者链接、评分、点赞数、时间和公司汇总字段为空。
- 持续读取 results.next_cursor，直到 results.has_more 为 false，避免遗漏已保存的大任务结果。
相关 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 Comment Replies API — 使用已知评论的 feedback ID 和 expansion token 获取公开回复，返回文本、作者标识、互动指标和父级上下文。
- 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，返回说明文字、作者上下文、视频元数据、可见互动和来源引用。