跳到导航

country_code=US 能只拿美国用户的评论吗?

不能。country_code: US 只是 youtube.web_v2.get_video_comments 的采集区域设置,不会把返回结果限定为位于美国的评论者。要筛出与美国市场有关的反馈,需检查评论原句是否明确提到当地使用、购买或配送,并将这类信息标为评论者自述。

场景:产品团队想看美国市场的投诉

产品团队要求查看「美国市场的投诉」时,可能对应两种不同的交付口径:

  • US 请求设置下取得的评论:记录 country_code=US、所选视频、排序方式、语言设置、采集时间和实际覆盖范围,形成可复现的采集说明。
  • 明确提到美国使用情境的投诉:保留支持市场判断的原句,并标为「评论者自述」,不要标成「已验证居住地/国籍」。美元价格、英语正文、昵称或国旗表情都不能单独作为地点证据。

评论未提到地点时记录为「未提及」。「寄到美国花了两周」只能说明这一次配送,不能证明评论者的长期住址,也不能证明评论者是已验证买家。报告结论中应明确区分请求参数与评论者原句证据。

明确保存采集设置

{"action":"youtube.web_v2.get_video_comments","params":{"video_id":"<eleven_character_video_id>","country_code":"US","language_code":"en-US","sort_by":"newest","need_format":true}}

将 <eleven_character_video_id> 替换为真实的 11 字符视频 ID。以上 JSON 仅展示 Social Data 请求参数,不是评论响应字段样例。当前 country_code 默认值为 US,language_code 默认值为 zh-CN,两项都应显式记录,以免读者误以为默认参数均为英文。en-US 既不会把评论翻译成英文,也不保证只返回英语评论。修改 country_code 或 language_code 时,需记录新的查询条件,不得沿用原查询条件下的 continuation_token。

报告具体写什么?

交付表格建议包含以下列:来源视频、采集条件与时间、投诉原文、市场判断的支持原句、证据状态(自述/未提及)。仅在已核实的响应映射中确认存在评论 ID 字段时才填写评论 ID,不要新增 IP 地址或地理定位字段。

结论示例:「这些是所选视频在已记录的 US 请求设置下观察到的投诉;市场相关陈述另行标注,未建立经过验证的美国买家数量。」该示例为报告模板,并非已采集样本的统计结果。英语评论占比不等于美国观众占比,top 和 newest 也都不是全部评论者的随机抽样。

每请求一页评论均按次计费,当前单价见 BeatAPI 价格页。

语言设置 · 排序方式 · YouTube 研究流程

免费依据:data:youtube.web_v2.get_video_comments。