Facebook Reels
Facebook Reels 是个人资料或 Page 内容流中的公开短视频，包含说明文字、作者上下文、播放元数据、发布时间和可见互动。这些记录可用于建立内容清单、研究短视频形式、监测内容流变化并进行对比分析。
主要特性
- 多主页 Reel 内容流从一个或多个 Facebook 个人资料或 Page URL 采集公开 Reel 记录，对每个输入分别应用请求上限，并保留 extra.input_url 用于来源归属。
- 标准化视频媒体随 Reel ID 和公开来源链接返回视频 URL、缩略图、尺寸和时长元数据。
- 创作者与互动上下文为每条标准化 Reel 保留说明文字、原始公开作者上下文、可见点赞、评论、观看、播放、分享和发布时间。
- 稳定读取内容流沿各主页的 cursor 继续读取，并按 ID、post ID 或 URL 去除重复 Reel，直至达到每个输入的数量上限。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | Facebook 公开个人资料或 Page URL，多个值使用逗号或换行分隔。 |
results_limit | 可选 | 每个输入 URL 最多采集 20 至 2,000 条 Reels，默认值为 100。 |
如何使用
把公开个人资料或 Page URL 作为异步任务提交，轮询 task ID，完成后再用结果 cursor 分页读取标准化 Reel 记录。
- 准备一个或多个能够公开显示 Reel 内容流的 Facebook 个人资料或 Page URL。
- 向 /v1/facebook/reels POST urls 和可选的 results_limit。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded。
- 通过 /v1/tasks/{task_id}?limit=50 读取结果，有更多已保存 Reels 时继续传入 results.next_cursor。
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'
# 轮询 GET /v1/tasks/{task_id}，再读取 /v1/tasks/{task_id}?limit=50，并使用 data.results。最佳使用场景
- 主页 Reel 内容清单： 把 Reel ID、来源链接、说明文字、视频引用、发布时间和 extra.input_url 整理为指定主页的内容索引。
- 短视频形式研究： 比较时长、尺寸、缩略图、说明文字和可见互动，研究公开 Reels 的内容呈现与反馈。
- Reel 内容流监测： 重复采集指定个人资料或 Page URL，并结合稳定 Reel 标识与发布时间发现新出现的记录。
使用建议
- 使用 facebook.com、www.facebook.com 或 m.facebook.com 上能够公开显示 Reel 内容流的个人资料或 Page URL；仅通过主机校验不代表目标资源一定适用。
- 根据输入 URL 数量设置 results_limit，因为 20 至 2,000 的数量限制会分别应用到每个 URL。
- 合并重复采集结果时，结合 Reel ID、post ID 或 URL 与 extra.input_url 去重，保留正确的来源主页。
- 把说明文字、作者字段、指标、时间和媒体元数据视为可选值，渲染或下载前先确认 media 中存在视频 URL。
- 需要口述文字时，把已知 Reel URL 提交给 Facebook Video Transcript API，不要期待 Reel 记录直接包含字幕文本。
相关 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 Profiles API — 通过已知 Facebook URL 查询公开个人资料或主页，返回身份信息、简介、头像、可见计数和输入上下文。