Facebook Group Posts
Facebook Group Posts 是群组内公开可见的动态，包含帖子文字、作者身份、发布时间、来源链接、可见回应、评论数、观看数和视频媒体。这些记录可用于群组动态监测、讨论研究、互动比较和公开内容报表。
主要特性
- 批量输入公开群组 URL一次接受一个或多个 Facebook 公开群组 URL，并在每条标准化帖子中保留来源群组 URL。
- 四种群组排序方式可用 top_posts、recent_activity、chronological 或 chronological_listings 为提交的所有群组选择排序。
- 控制每个群组的采集深度results_limit 分别应用于每个群组 URL，默认值为 100，可设置为 3 到 2,000 的整数。
- 帖子与作者上下文以一致结构返回帖子 ID、来源 URL、正文、作者 ID 与名称、发布时间和采集时间。
- 可见互动与视频信息公开帖子提供相应信息时，返回回应数、评论数、视频观看数以及标准化视频和缩略图 URL。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的 Facebook 公开群组 URL，多个值使用逗号或换行分隔。 |
results_limit | 可选 | 每个群组 URL 最多请求的帖子数；默认值为 100，可设置为 3 到 2,000 的整数。 |
sort_by | 可选 | 应用于所有提交群组的可选排序：top_posts、recent_activity、chronological 或 chronological_listings。 |
如何使用
提交公开群组 URL，并可选择排序和设置每个群组的结果上限，再通过 cursor 分页读取异步任务结果。
- 准备一个或多个 Facebook 公开群组 URL。
- 将 urls、可选的 results_limit 和 sort_by POST 到 /v1/facebook/group-posts，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；has_more 为 true 时继续请求返回的 next_cursor。
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 复核公开群组动态： 结合 recent_activity 或 chronological 排序，以及 message、author、created_at 和 group_url 字段，复核所选群组的公开更新。
- 构建群组讨论归档： 保存帖子 ID、正文、作者信息、来源 URL、发布时间和采集时间，形成可归属来源的公开群组记录。
- 对齐比较群组互动： 对多个群组 URL 使用相同 sort_by，再比较 reactions_count、comments_count 和 views_count。
使用建议
- 提交可直接访问的公开群组 URL，而不是只填写群组名称，确保每项输入都对应明确来源。
- 按 urls 数量乘以 results_limit 计算请求深度，因为结果上限分别应用于每个群组。
- 比较不同排序时分别提交任务，因为一次请求中的所有群组 URL 共用同一个 sort_by。
- 同时保留 id 和 extra.group_url，便于下游数据维持来源归属并在群组内去重。
- 公开帖子未提供相应信息时，author、message、发布时间、视频媒体和视频观看数可能为空，下游处理应允许字段缺失。
- 完成任务包含多页结果时，持续使用 results.next_cursor，直到 has_more 变为 false。
相关 API
需要其他类型的 Facebook 公开数据时，可以使用以下 API。
- Facebook Pages API — 获取公开 Page 资料、联系方式、图片和可见受众评分。
- Facebook Posts API — 从受支持的 Facebook URL 采集公开帖子、媒体、表情回应、评论数和分享数。
- Facebook Comments API — 从帖子 URL 采集公开评论、作者、互动、媒体和来源链接。
- Facebook Video Transcript API — 从已知的公开视频帖子或 Reel 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，返回说明文字、作者上下文、视频元数据、可见互动和来源引用。