YouTube Community Post
社区帖子是创作者发在频道“帖子”页上的动态,可能是公告、提问、一组图片或一个链接,各自带有正文、配图和点赞数。拿到完整的帖子内容,就能把创作者说过的话存档,衡量某一条动态在粉丝中的反响,也能为它下面的评论补上上下文。
YouTube Community Post API 主要特性
- 两种帖子链接都能用可以填 youtube.com/post/{post_id} 链接,也可以填末尾带 ?lb={post_id} 的频道帖子页链接,两者指向同一条帖子。
- 完整正文和全部配图text 是保留换行的完整正文,media 列出每一张配图,不只是第一张。
- 点赞数和发帖频道metrics.likes_count 是点赞总数,author 包含频道 ID、账号名、频道名称和链接。
YouTube Community Post API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 社区帖子链接:https://www.youtube.com/post/{post_id},或带 ?lb={post_id} 的频道帖子页链接。 |
如何使用 YouTube Community Post API
提交一条帖子链接,读回这条帖子的记录。
- 复制一条社区帖子链接,比如来自 YouTube Community Posts 的结果或分享链接。
- 向 /v1/youtube/community-post 发送 {"url": "https://www.youtube.com/post/Ugkx..."}。
- 轮询 GET /v1/tasks/{task_id},status 变成 succeeded 后,在 results.items 里读取这条帖子。
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'
# 结果是一条帖子,包含 text、media 和 metrics.likes_count。YouTube Community Post API 最佳使用场景
- 存档创作者公告: 把新品发布、抽奖、更新时间表这类帖子的完整正文和配图存下来,之后帖子被修改或删除也不影响留档。
- 评估单条动态的反响: 取出指定帖子的 likes_count,对比同一创作者的公告、投票和图片动态各自的表现。
YouTube Community Post API 使用建议
- 先用 YouTube Community Posts 列出频道最近的帖子,再只对需要完整内容的几条调用本接口。
- 用同一个链接调用 YouTube Community Post Comments,就能把帖子和观众的回应放在一起看。
相关 API
除了 YouTube Community Post API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。
- YouTube Channel Videos API — 通过频道 URL 采集公开普通视频,不包含 Shorts 和直播。
- YouTube Transcripts API — 获取可用纯文本字幕,并支持可选语言。
- YouTube Channels API — 获取公开频道身份、图片、认证状态和可见受众统计。
- YouTube Videos API — 获取已知视频或 Short URL 的元数据、缩略图、时长和互动指标。
- YouTube Community Posts API — 通过频道 URL 采集公开社区帖子,返回正文、频道身份、发布时间、图片引用和来源关系。
- YouTube Community Post Comments API — 按社区帖子链接采集评论,返回评论者频道、点赞数和回复数。
- YouTube Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API