Facebook Pages
Facebook Pages 是企业、组织、创作者和公众人物使用的公开主页，包含身份、分类、简介、图片、联系方式和受众信号。这些主页资料和受众字段可用于品牌发现、目录补全、市场研究和账号对比。
主要特性
- 批量主页采集通过一个或多个公开 Page URL 采集 Facebook Page。
- 主页身份与图片以标准化主页字段返回名称、分类、简介、标准 URL、头像和封面图。
- 可见受众指标通过一致的 metrics 对象返回可见粉丝数、主页点赞数、评论数和评分。
- 公开联系方式返回公开网站、邮箱、电话和地址，用于补全联系方式与主页目录。
- 公开数据边界结果仅限可公开访问的 Page 数据，不包含私密、受限或登录后才可见的内容。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 公开 Facebook 公共主页 URL，多个值使用逗号或换行分隔。 |
results_limit | 可选 | 采集任务请求的最大记录数，必须为正整数。 |
如何使用
先提交异步采集任务，轮询 task ID，任务完成后再用 cursor 分页读取标准化 Page 结果。
- 准备一个或多个公开 Facebook Page URL。
- 向 /v1/facebook/pages POST urls 和可选的 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 通过 /v1/tasks/{task_id}?limit=50 读取 data.results，并用 results.next_cursor 分页。
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}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results。最佳使用场景
- 品牌主页监控： 收集公开主页身份、分类、联系方式和受众指标，用于自有或竞品主页跟踪。
- 主页基准数据集： 对比所选 Pages 的分类、简介、联系方式覆盖、粉丝数、评分和其他可见受众信号。
- 报表和 BI 管道： 把标准化的公开主页记录接入仪表盘、表格、数据仓库或内部审核工具。
- 媒体归档流程： 保存 Page URL、图片、简介、联系方式和可见指标，供后续审核或报表使用。
- 公开社媒监听： 用公开主页身份和受众信号补全社媒账号目录和品牌数据集。
使用建议
- 开始大批量任务前，先确认每个输入 URL 都能打开对应的 Facebook 公开 Page。
- 有些公开主页可能不会稳定暴露联系方式、图片、评分或受众计数，客户端需要能处理字段缺失。
- 保存稳定 Page ID 和标准 URL，方便任务重试、审计和去重。
- 需要公开帖子记录时，使用 Facebook Posts API。
- 不要围绕私密主页、受限帖子、登录后页面或账号自有数据设计工作流，除非后续公开文档明确支持。
相关 API
需要其他类型的 Facebook 公开数据时，可以使用以下 API。
- 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 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，返回说明文字、作者上下文、视频元数据、可见互动和来源引用。