Facebook 公开数据 API
通过统一 API 流程采集公开 Facebook Page、帖子和评论记录，获得标准化身份、内容、作者、媒体、reaction 和互动字段。
可用的 Facebook API
Pages 用于公开主页字段，Posts 用于公开内容，Comments 用于公开讨论记录；三个接口使用相同的鉴权与任务结果流程。
可以获取哪些 Facebook 数据？
SocQ 将受支持的公开 Facebook 结果转换成一致的 JSON 记录，用于数据补全、监控、研究和报表流程。
公开 Page 资料
在字段公开可见时采集主页名称、分类、简介、标准 URL、头像和封面图。
联系方式与受众字段
在公开结果暴露时返回网站、邮箱、电话、地址、粉丝数、主页点赞、评分和评论数。
公开帖子内容
采集帖子文本、作者、时间、链接、图片、视频引用和标准化帖子 ID。
公开评论与互动
在字段可用时采集公开评论文本、作者、时间、点赞数、回复数、分享和 reaction 信号。
SocQ 与 Facebook Graph API 对比
SocQ 面向受支持的公开数据采集；需要管理用户或企业明确授权的资产时，应选择 Meta Graph API。
| 能力 | SocQ | Facebook Graph API |
|---|---|---|
| 主要用途 | 采集公开 Page、帖子和评论数据 | 管理已授权 Page、应用和资产 |
| 用户 OAuth | 使用 SocQ API key，无需用户 Facebook OAuth | 需要 Meta 应用审核、权限和 access token |
| 创建或编辑帖子 | 不支持 | 获得相应 Page 权限后可用 |
| 私密或受限数据 | 不支持 | 仅限授权权限允许的数据 |
| 响应格式 | 标准化 SocQ 记录 | Graph API 原生对象 |
Facebook API 如何工作
采集任务异步运行，业务应用可以分别完成任务提交、状态监控和结果分页处理。
1. 提交公开 URL
通过 POST 传入一个或多个受支持的公开 Page、profile、group 或 post URL，并可指定 results_limit。
2. 轮询任务
使用返回的 task ID 等待处理成功或失败，遇到临时压力响应时进行 backoff。
3. 读取并分页
获取标准化结果记录，任务包含更多数据时继续传 next_cursor。
使用 SocQ API key 鉴权。以下示例启动公开 Facebook Page 任务；帖子使用 /v1/facebook/posts，评论使用 /v1/facebook/comments。
curl -X POST "https://api.socq.ai/v1/facebook/pages" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 GET /v1/tasks/{task_id}?limit=50常见 Facebook API 使用场景
品牌监控
跟踪自有品牌或竞品的公开 Page 身份、联系方式、受众和帖子信号。
内容与反馈研究
分析公开帖子、评论文本、作者、发布时间、媒体和可见互动，用于报表或编辑研究。
主页数据补全
为 CRM、目录或账号记录补充公开 Facebook 身份、分类、联系方式和受众字段。
报表管道
把标准化公开 Page 和帖子记录接入仪表盘、数据仓库和内部审核工具。
限制与公开数据政策
Facebook 公开结果是动态的；某个 Page 或帖子可见的字段，在其他记录中可能缺失，也可能随时间发生变化。
- 不支持私密 group、受限 profile、已删除帖子和登录后才可见的内容。
- 公开记录可能缺少联系方式、评论作者、媒体、计数、时间、回复或 reaction 细分。
- 建议使用较小批次和保守请求频率，并在临时阻断或限速后进行 backoff。
- 这些接口不用于创建、更新、审核或删除 Facebook 内容。
Facebook API 常见问题
这是 Facebook 官方 Graph API 吗？
不是。SocQ 对受支持的公开 Facebook 结果进行标准化；需要授权 Page 管理、发布和审核时，应使用 Meta Graph API。
用户需要连接 Facebook 账号吗？
受支持的公开数据接口不需要用户 Facebook OAuth，请求使用 SocQ API key 鉴权。
SocQ 可以采集私密 group 或 profile 吗？
不可以。私密、受限和登录后才可见的 Facebook 内容不在支持范围内。
如何计费？
每个接口卡片会显示当前每条结果的积分价格，任务按照返回的标准化记录计费。