YouTube Community Posts API

YouTube Community Posts

主要特性

• 多频道 URL 采集接受使用 @handle、/channel/、/c/ 或 /user/ 路径的完整公开频道 URL，并分别对每个频道应用所选结果上限。
• 标准化帖子记录以一致结构返回公开帖子 ID、社区帖子 URL、正文、发布时间和采集时间。
• 频道与帖子关系为每条帖子保留频道 ID、handle、显示名称、公开频道 URL 和提交的来源 URL。
• 图片附件引用把帖子中公开显示的图片转换为标准化 media 条目，使图片动态与对应帖子记录保持关联。
• 有边界的动态续页分别为每个频道读取后续来源页面，按帖子 ID 或 URL 去重，并在达到所选上限、动态结束或 100 页上限时停止。

参数

如何使用

把一个或多个已知公开频道作为异步任务提交，再从完成的任务中读取已保存的社区帖子记录。

1. 准备使用 @handle、/channel/、/c/ 或 /user/ 路径的完整 YouTube 公开频道 URL。
2. 将 urls 和 20 到 2000 的 results_limit POST 到 /v1/youtube/community-posts。
3. 保留返回的 task_id，并在任务处于 queued、running 或 retrying 时轮询 GET /v1/tasks/{task_id}。
4. 任务成功后读取 data.results.items；当 data.results.has_more 为 true 时，把 data.results.next_cursor 作为 cursor 继续请求该任务。

curl -X POST "https://api.socq.ai/v1/youtube/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时把 data.results.next_cursor 作为 cursor 继续请求

最佳使用场景

• 频道社区动态整理： 使用帖子 ID、URL、正文、时间和来源频道关系，为选定公开频道建立可审阅的动态列表。
• 公告与创意内容审阅： 结合公开帖子正文和保留的图片引用，比较频道在视频动态之外如何呈现更新。
• 跨频道发布活动分析： 按频道身份和发布时间组织标准化帖子，比较一组已知频道的社区发布活动。

使用建议

• 提交受支持 YouTube 主机上的完整频道 URL；视频、帖子、播放列表 URL 和不带主机名的值不符合公开频道输入规则。
• 规划多频道请求时注意 results_limit 会作用于每个 URL：三个频道各设为 20，最多会请求保存 60 条帖子。
• 把 results_limit 视为上限，因为没有公开社区标签页或可见动态较少的频道会返回更少记录。
• cursor 只用于 GET /v1/tasks/{task_id}；来源续页由系统内部处理，不是此接口的公开请求参数。
• 保存数据时优先按帖子 ID 去重，没有 ID 时再使用 URL；合并多个频道时保留 extra.input_url。
• 下游处理前检查 text、media 和 created_at；当前标准化记录不保留投票选项或内嵌视频附件信息。

相关 API