Facebook Profiles
Facebook 个人资料和主页是公开身份页面，包含名称、简介或 about 文字、头像、规范链接，以及可见受众或活动计数。这些身份字段和公开信号可用于 URL 补全、实体匹配、元数据快照和对比研究。
主要特性
- 通过已知 URL 直接查询提交多个 Facebook 公开个人资料或主页 URL，每个输入最多返回一条标准化个人资料记录。
- 标准化身份字段以一致结构返回 Facebook ID、规范 URL、显示名称、记录类型和原始输入 URL。
- 公开资料展示字段采集公开 bio、intro、description 或 about 文字，并返回可用的个人资料或主页头像。
- 可见资料计数标准化目标公开展示的关注者、正在关注、帖子、点赞、评论、观看、播放和分享计数。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的 Facebook 公开个人资料或主页 URL。接受 facebook.com、www.facebook.com 和 m.facebook.com；多个值可用逗号或换行分隔。 |
如何使用
把个人资料或主页 URL 作为异步任务提交，轮询 task ID，完成后读取标准化个人资料记录。
- 准备一个或多个 facebook.com、www.facebook.com 或 m.facebook.com 上的公开个人资料或主页 URL。
- 向 /v1/facebook/profiles POST urls。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded。
- 通过 /v1/tasks/{task_id}?limit=50 读取 data.results.items，并在 results.has_more 为 true 时继续传 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"]}'
# 轮询 GET /v1/tasks/{task_id}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results.items。最佳使用场景
- 个人资料与主页目录补全： 为已知 Facebook URL 目录补充标准化 ID、名称、规范链接、简介文字、头像和可见计数。
- 已知 URL 身份匹配： 使用返回的 ID、规范 URL、名称和 extra.input_url，把提交链接关联到已有实体记录。
- 公开元数据快照： 结合 collected_at 保存可用的资料文字、头像和计数，用于比较多次采集中的公开元数据。
使用建议
- 提交前确认每个 URL 指向目标个人资料或主页，因为请求校验只检查 Facebook 主机名，不检查资源路径。
- 处理多 URL 任务时保留 extra.input_url，因为重复或不可用输入可能使返回记录少于提交数量。
- 把名称、资料文字、头像和各项指标按可空字段处理，因为个人资料与主页公开的字段不同。
- 需要帖子、照片、Reels、活动或评论时，使用对应 Facebook 内容端点，而不是把个人资料元数据当作内容集合。
相关 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 Company Reviews API — 采集公开 Page 评价，返回评价文本、评价者链接、评分、点赞数、时间和公司上下文。
- Facebook Event Details API — 通过已知公开活动 URL 采集标准化元数据、日程、地点、媒体和可见互动指标。
- Facebook Profile Events API — 从个人资料或 Page URL 采集关联的公开活动，返回名称、日程、地点、媒体、可见指标和来源上下文。
- Facebook Profile Photos API — 从个人资料或 Page URL 采集公开照片，返回说明文字、作者上下文、互动指标、图片元数据和来源引用。
- Facebook Reels API — 从个人资料或 Page URL 采集公开 Reels，返回说明文字、作者上下文、视频元数据、可见互动和来源引用。