YouTube Community Post Comments
社区帖子评论是粉丝在创作者“帖子”页动态下留下的回应,每条都有评论内容、评论者频道、点赞数和它引出的回复数。这些讨论和视频评论是分开的,最能反映观众在两次更新之间如何看待创作者的投票、公告和幕后分享。
YouTube Community Post Comments API 主要特性
- 凭帖子链接取评论提交帖子的 /post/ 链接或带 ?lb= 的帖子页链接,评论会自动翻页采集,直到达到 results_limit,最多 1000 条。
- 每条都带评论者频道author 包含评论者的频道 ID、账号名、频道链接、头像和认证标记。
- 点赞数和讨论热度metrics.likes_count 和 metrics.replies_count 能看出哪些评论获得认同,哪些评论引发了讨论。
- 直达评论的链接每条结果的 url 会打开帖子并定位到这条评论,post_id 则把它和所属帖子关联起来。
YouTube Community Post Comments API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 社区帖子链接:https://www.youtube.com/post/{post_id},或带 ?lb={post_id} 的频道帖子页链接。 |
results_limit | 可选 | 返回的评论数量,取值 1 到 1000,默认 100。 |
如何使用 YouTube Community Post Comments API
提交帖子链接,分页读取评论。
- 向 /v1/youtube/community-post-comments 发送 {"url": "https://www.youtube.com/post/Ugkx...", "results_limit": 100}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 results.items 读取评论;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ","results_limit":100}'
# 每条结果是一条评论,包含 author、metrics.likes_count 和 metrics.replies_count。YouTube Community Post Comments API 最佳使用场景
- 读懂投票和公告的反馈: 取出创作者投票帖或新品公告下的评论原文,看看粉丝在投票数字之外具体说了什么。
- 找出最活跃的粉丝: 把一个频道多条帖子的评论按 author.id 归类,看哪些观众反复出现。
- 挑出关键评论: 按 likes_count 和 replies_count 排序,找到社区最认同或争论最多的评论。
YouTube Community Post Comments API 使用建议
- 评论上千条的帖子,先用适中的 results_limit 跑一次,第一批有价值再调大。
- 保存评论的 id,之后再次采集同一条帖子时按 id 去掉重复项。
- 需要把帖子正文和评论放在一起看时,用同一个链接调用 YouTube Community Post。
相关 API
除了 YouTube Community Post Comments API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。
- YouTube Channel Videos API — 通过频道 URL 采集公开普通视频,不包含 Shorts 和直播。
- YouTube Comments API — 采集公开评论、作者、互动、来源视频和对话关系。
- YouTube Channels API — 获取公开频道身份、图片、认证状态和可见受众统计。
- YouTube Comment Replies API — 使用回复令牌继续读取已知 YouTube 评论下的公开回复,返回作者、互动和父评论信息。
- YouTube Community Posts API — 通过频道 URL 采集公开社区帖子,返回正文、频道身份、发布时间、图片引用和来源关系。
- YouTube Community Post API — 凭链接读取一条社区帖子,返回完整正文、配图、点赞数和发帖频道。
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos 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