YouTube 视频评论实时抓取（高级版）

POST /v3/serp/youtube/video_comments/live/advanced

接口概述

该接口用于实时获取指定 YouTube 视频下的评论数据。调用后可返回该视频的前 20 条评论，以及评论信息和互动指标。

• 请求方式：POST
• 接口地址：https://api.seermartech.cn/v3/serp/youtube/video_comments/live/advanced

计费说明

该接口按请求计费。

参考价约 ¥0.0320 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用规则

• 所有 POST 数据使用 JSON（UTF-8 编码）
• 请求体格式为 JSON 数组：[{ ... }]
• 单次 Live SERP 请求只能提交 1 个任务
• 最高支持 每分钟 2000 次 API 调用

---

请求参数

以下为任务对象中可用字段说明。

字段名	类型	说明
video_id	string	填，视频 ID。可从视频 URL 中获取，也可从 /v3/serp/youtube/organic/live/advanced 的 youtube_video 结果项中获取。示例：vQXvyV0zIP4
location_name	string	搜索引擎地区完整名称。若未传 location_code，则此字段填。传此字段时无需再传 location_code。可通过 POST /v3/serp/youtube/locations 获取可用地区列表。示例：United States
location_code	integer	搜索引擎地区编码。若未传 location_name，则此字段填。传此字段时无需再传 location_name。可通过 POST /v3/serp/youtube/locations 获取可用地区列表。示例：2840
language_name	string	搜索引擎语言完整名称。若未传 language_code，则此字段填。传此字段时无需再传 language_code。可通过 POST /v3/serp/youtube/languages 获取可用语言列表。示例：English
language_code	string	搜索引擎语言代码。若未传 language_name，则此字段填。传此字段时无需再传 language_name。可通过 POST /v3/serp/youtube/languages 获取可用语言列表。示例：en
device	string	设备类型。可选，当前支持：desktop
os	string	设备操作系统。可选，可选值：windows、macos。默认值：windows
depth	integer	抓取深度，即返回的评论数量上限。可选，默认值：20，最大值：700。注意： 每 20 条结果按一个 SERP 单计费；若 depth 大于 20，且搜索引擎返回 20 条结果，可能产生额外费用；若设置的 depth 高于返回数量，差额会自动退回到账户余额。
tag	string	自定义任务标识。可选，最大长度 255 字符。可用于请求与响应结果的对应，返回时会出现在响应的 data 对象中。

---

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	局状态码，完整列表见 /v3/appendix/errors
status_message	string	局状态信息，完整列表见 /v3/appendix/errors
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务结果数组

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000–60000，完整列表见 /v3/appendix/errors
status_message	string	任务状态信息
time	string	任务执行耗时，单位秒
cost	float	任务费用，单位 USD
result_count	integer	result 数组中的结果数量
path	array	请求路径
data	object	与请求中提交的参数一致
result	array	结果数组

result[] 字段

字段名	类型	说明
video_id	string	请求中的视频 ID
se_domain	string	请求对应的搜索引擎域名
location_code	integer	请求中的地区编码
language_code	string	请求中的语言代码
check_url	string	结果页直达链接，可用于人工核对结果准确性
datetime	string	抓取时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
spell	object	搜索引擎自动纠错信息；若发生纠错，会返回纠正后的及纠错类型
refinement_chips	object	搜索细化建议；该接口中通常为 null
item_types	array	SERP 中返回的结果类型列表。当前可能值：youtube_comment
title	string	视频标题
comments_count	integer	视频评论总数
items_count	integer	items 数组中的结果数
items	array	评论结果列表

items[] 字段

字段名	类型	说明
type	string	结果类型，固定为 youtube_comment
rank_group	integer	同类型结果组排名
rank_absolute	integer	在结果中的绝对排名
author_name	string	评论名称
author_thumbnail	string	频道头像图片所在页面 URL
author_url	string	频道 URL
text	string	评论正文
publication_date	string	页面展示的发布时间
timestamp	string	评论发布时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
likes_count	integer	评论点赞数
reply_count	integer	评论回复数

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/serp/youtube/video_comments/live/advanced" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "language_code": "en",
 "location_code": 2840,
 "video_id": "vQXvyV0zIP4"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/serp/youtube/video_comments/live/advanced"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "language_code": "en",
 "location_code": 2840,
 "video_id": "vQXvyV0zIP4"
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.json)

TypeScript

import axios from "axios";

async function fetchYoutubeVideoComments {
 const response = await axios.post(
 "https://api.seermartech.cn/v3/serp/youtube/video_comments/live/advanced",
 [
 {
 language_code: "en",
 location_code: 2840,
 video_id: "vQXvyV0zIP4",
 },
 ],
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
 }
 );

 console.log(response.data);
}

fetchYoutubeVideoComments.catch(console.error);

---

响应示例

{
 "version": "0.1.20220819",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "4.1248 sec.",
 "cost": 0.002,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "live",
 "se": "youtube",
 "se_type": "video_comments",
 "language_code": "en",
 "location_code": 2840,
 "video_id": "vQXvyV0zIP4",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "title": "The first-ever BMW M5 CS.",
 "comments_count": 4080,
 "items_count": 20,
 "items": []
 }
 ]
 }
 ]
}

---

状态码与错误处理

• 顶层 status_code 表示整次请求的处理结果
• tasks[].status_code 表示单个任务的处理结果
• 建议同时检查：
• HTTP 状态码
• 顶层 status_code
• tasks[].status_code

常见判断方式：

• 20000：请求成功
• 状态码：表示参数错误、认证失败、额限制或服务返回异常等

完整错误码说明请参考：/v3/appendix/errors

---

使用建议

1. video_id须准确，否则无法返回目标视频评论。
2. 若需要更多评论数据，可调高 depth，但应注意可能产生额外计费。
3. 建议优使用 location_code 与 language_code，便于程序稳定处理。
4. 若需要结果追踪与回溯，可使用 tag 业务侧任务 ID。
5. 返回结果中的 check_url 可用于人工抽样核验。

实用场景

• 监控舆反馈：抓取品牌视频或竞品视频下的最新评论，快速识别用户绪、争议点和高频反馈。
• 筛选高互动评论：基于 likes_count 和 reply_count 找出高热度评论，为社区运营、置顶回复和互动提供依据。
• 分析受众点：提取评论文本 text，归纳用户最心的产品特性、使用问题和购买意向。
• 跟踪视频发布后反馈变化：结合 timestamp 与 publication_date 观察评论在发布时间后的增长节奏，评估传播效果。
• 对比地区与语言差异：按不同 location_code、language_code 抓取评论结果，分析不同市场用户的反馈偏好。