Facebook 公开数据 API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
可用的 Facebook API
Pages 用于公开主页字段，Posts 用于通用内容，Group Posts 用于群组 URL 记录，Comments 用于讨论，Events Search 用于关键词活动，Video Transcripts 用于从已知视频帖子或 Reel URL 获取可用口播文本；六个接口使用相同的鉴权与任务结果流程。
facebook/pages
主页每条结果 2.4 积分
facebook/posts
帖子每条结果 1 积分
facebook/group-posts
帖子每条结果 1.2 积分
facebook/reels
帖子每条结果 0.7 积分
facebook/comments
评论每条结果 0.3 积分
facebook/comment-replies
评论每条结果 0.3 积分
facebook/company-reviews
评论每条结果 0.5 积分
facebook/video-transcript
帖子每条结果 0.7 积分
facebook/ad-transcript
帖子每条结果 0.5 积分
facebook/events-search
搜索每条结果 0.6 积分
facebook/event-details
搜索每条结果 0.5 积分
facebook/profile-events
主页每条结果 0.6 积分
facebook/profile-photos
帖子每条结果 0.5 积分
facebook/profiles
主页每条结果 1.2 积分
可以获取哪些 Facebook 数据？
SocQ 将受支持的公开 Facebook 结果转换成一致的 JSON 记录，用于数据补全、监控、研究和报表流程。
公开 Page 资料
在字段公开可见时采集主页名称、分类、简介、标准 URL、头像和封面图。
联系方式与受众字段
在公开结果暴露时返回网站、邮箱、电话、地址、粉丝数、主页点赞、评分和评论数。
公开帖子内容
采集帖子文本、作者、时间、链接、图片、视频引用和标准化帖子 ID。
公开评论与互动
在字段可用时采集公开评论文本、作者、时间、点赞数、回复数、分享和 reaction 信号。
公开活动发现
按关键词搜索活动名称、日程、地点、出席信号、封面图片以及线上或已结束状态。
可用视频字幕
从已知的公开视频帖子或 Reel URL 提取关联来源的字幕文本及 plaintext 或 WebVTT 格式。
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. 提交输入
根据所选接口文档，通过 POST 传入受支持的公开 Page、post、group、视频帖子或 Reel URL，或为活动搜索提交关键词 query。
2. 轮询任务
使用返回的 task ID 等待处理成功或失败，遇到临时压力响应时进行 backoff。
3. 读取并分页
获取标准化结果记录，任务包含更多数据时继续传 next_cursor。
使用 SocQ API key 鉴权。以下示例启动公开 Facebook Page 任务；通用帖子使用 /v1/facebook/posts，群组帖子使用 /v1/facebook/group-posts，评论使用 /v1/facebook/comments，活动搜索使用 /v1/facebook/events-search，已知视频帖子或 Reel URL 使用 /v1/facebook/video-transcript。
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 和帖子记录接入仪表盘、数据仓库和内部审核工具。
语音内容索引
将可用字幕文本与来源 URL 和格式一起建立索引，用于选定的公开视频帖子和 Reel。
限制与公开数据政策
Facebook 公开结果是动态的；某个 Page、帖子、评论、活动或字幕来源可见的字段，在其他记录中可能缺失，也可能随时间发生变化。
- 不支持私密 group、受限 profile、已删除帖子和登录后才可见的内容。
- 公开记录可能缺少联系方式、评论作者、媒体、计数、时间、回复或 reaction 细分。
- 提交的公开视频 URL 没有可用的非空字幕文本时，不会生成字幕记录。
- 建议使用较小批次和保守请求频率，并在临时阻断或限速后进行 backoff。
- 这些接口不用于创建、更新、审核或删除 Facebook 内容。
Facebook API 常见问题
这是 Facebook 官方 Graph API 吗？
不是。SocQ 对受支持的公开 Facebook 结果进行标准化；需要授权 Page 管理、发布和审核时，应使用 Meta Graph API。
用户需要连接 Facebook 账号吗？
受支持的公开数据接口不需要用户 Facebook OAuth，请求使用 SocQ API key 鉴权。
SocQ 可以采集私密 group 或 profile 吗？
不可以。私密、受限和登录后才可见的 Facebook 内容不在支持范围内。
如何计费？
每个接口卡片会显示当前每条结果的积分价格，任务按照返回的标准化记录计费。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。