Facebook Pages API

Facebook Pages

主要特性

• 批量主页采集通过一个或多个公开 Page URL 采集 Facebook Page。
• 主页身份与图片以标准化主页字段返回名称、分类、简介、标准 URL、头像和封面图。
• 可见受众指标通过一致的 metrics 对象返回可见粉丝数、主页点赞数、评论数和评分。
• 公开联系方式返回公开网站、邮箱、电话和地址，用于补全联系方式与主页目录。
• 公开数据边界结果仅限可公开访问的 Page 数据，不包含私密、受限或登录后才可见的内容。

参数

如何使用

先提交异步采集任务，轮询 task ID，任务完成后再用 cursor 分页读取标准化 Page 结果。

1. 准备一个或多个公开 Facebook Page URL。
2. 向 /v1/facebook/pages POST urls 和可选的 results_limit。
3. 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
4. 通过 /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