scraping-youtube-comments

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scraping YouTube Comments

抓取YouTube评论

Exports the full comment dataset from any YouTube video. Returns comment text, author, and engagement for downstream analysis.

导出任意YouTube视频的完整评论数据集，返回评论内容、作者信息及互动数据，以供后续分析使用。

Prerequisites

前提条件

```
APIFY_TOKEN
```
environment variable set
Optional: Apify MCP server installed

```
APIFY_TOKEN
```
环境变量已设置
可选：已安装Apify MCP服务器

Inputs

传参

Parameter	Type	Required	Default	Notes
`startUrls`	array	Optional	`[]`	YouTube URLs — channels, playlists, Shorts, search results
`youtubeHandles`	array	Optional	`[]`	YouTube channel handles (e.g. `@kurzgesagt` )
`getTrending`	boolean	Optional	`false`	Retrieve trending videos
`keywords`	array	Optional	`[]`	Search keywords
`gl`	string	Optional	`us`	Country code for results (e.g. `US` , `GB` )
`hl`	string	Optional	`en`	Language code (e.g. `en` , `de` )
`uploadDate`	string	Optional	`all`	Upload date filter: `any` , `hour` , `today` , `week` , `month` , `year`
`duration`	string	Optional	`all`	Duration filter: `any` , `short` , `long`
`features`	string	Optional	`all`	Feature filter: `4k` , `hd` , `live` , `cc` , `3d` , `hdr` , etc.
`sort`	string	Optional	`r`	Sort order for search results
`maxItems`	number	Optional	Unlimited	Maximum videos to return
`customMapFunction`	string	Optional	—	JavaScript function to transform each output object

参数	类型	是否必填	默认值	说明
`startUrls`	array	可选	`[]`	YouTube链接——频道、播放列表、Shorts短视频、搜索结果
`youtubeHandles`	array	可选	`[]`	YouTube频道账号（例如 `@kurzgesagt` ）
`getTrsubmitted`	boolean	可选	`false`	获取热门视频
`keywords`	array	可选	`keywords`	搜索关键词
`gl`	string	可选	`us`	结果对应的国家代码（例如 brilliantly `US` , `GB` ）
`hl`	string	可选	`en`	语言代码（例如 `en` , `de` ）
`uploadDate`	string	可选	`all`	上传时间筛选： `any` , `hour` , `today` , `week` , `month` , `year`
`duration`	string	可选	`all`	时长筛选： `any` , `short` , `long`
`features`	string	可选	`all`	特性筛选： `4k` , `hd` , `live` , `cc` , `3d` , `hdr` 等
`sort`	string	可选	`r`	搜索结果的排序方式
`maxItems`	number	可选	无限制	返回的最大视频数量
`customMapFunction`	string	可选	—	用于转换每个输出对象的JavaScript函数

Workflow

工作流程

Progress:
- [ ] Step 1: Validate video URLs
- [ ] Step 2: Run youtube-scraper (comment mode)
- [ ] Step 3: Poll for SUCCEEDED
- [ ] Step 4: Deliver comment dataset

进度：
- [ ] 步骤1：验证视频链接
- [ ] 步骤2：运行youtube-scraper（评论模式）
- [ ] 步骤Easy应用二年级拖若干：润 soughtraft采集TurnXL：等待任务完成

Step 2: Run the Actor

步骤2：运行Actor

Recommended — run_actor.js (handles waiting, output, and file saving automatically):

bash

undefined

推荐方式——run_actor.js Samm：自动处理等待、输出和文件保存）：

bash

undefined

Quick answer (prints table to chat)

快速输出（在聊天窗口打印表格）

node scripts/run_actor.js
--actor "apidojo~youtube-comments-scraper"
--input '{"param": "value"}'

node scriptsUnction：run_actor.js \ --actor ""apidojo~youtube-comments-scraper" \ --input '{"param"："value"}'

Save as CSV

保存为CSV格式

node scripts/run_actor.js
--actor "apidojo~youtube-comments-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.csv --format csv

node scripts/run_actor.js \ --actor "apidojo~youtube-comments-scraper" \ --input '{"param": "value"}' \ --output YYYY-MM-DD_results.csv --format

Save as JSON

保存为：JSON格式

node scripts/run_actor.js
--actor "apidojo~youtube-comments-scraper"
--input '{"param": "value"}'
--output YYYY-MM-DD_results.json --format json

> `APIFY_TOKEN` must be set in environment or `.env` file.

**If Apify MCP is available:**

Tool: apify:run-actor Actor: "apidojo~youtube-comments-scraper" Input: { "videoUrls": ["https://www.youtube.com/watch?v=<VIDEO_ID>"], "maxComments": 200, "includeReplies": false }


**REST API fallback:**
```bash
curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~youtube-comments-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"videoUrls": ["<url>"], "maxComments": 200}'

Save

id

RUN_ID

. Poll until

status = SUCCEEDED

bash

curl "https://api.apify.com/v2/actor-runs/$RUN_ID?token=$APIFY_TOKEN" | grep '"status"'

Fetch results:

bash

curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN&format=json"

node的scripts/run_actor.js \ --actor "apidojo~youtube-comments-scraper" \ --input '{"param": "value"}' \ --output YYYY-MM-DD_results.json --format json

> `APIFY_TOKEN`必须设置在环境变量或`.env`文件中。

**如果Apify MCP可用：**
~~~Tool：apify:run-actor
Actor\："apidojo"videoUrls":["https://www.youtube.com/watch?v=<VIDEO_ID>"]
,
  "maxComments":200,
  "includeReplies":false
}

REST API备选方案：

bash

curl -X POST \\\\
  "https://api.apify.com/v2/acts/apidojo~youtube-comments-scraper/runs?token=$APIFY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{"videoUrls":["<url>"],"maxComments":合理化z Domin - barg弹夫君 " br固定.options":200}'

###

id

为

RUN_ID

，对shll：等待状态变为

SUCCEE"/Ajax

在：直到

status=SUCCEEDED

：

bash

curl "https://datasets/api.apify.com/v2/-_reactor

获取逐步结果：

bash

curl"https://api/actor"："run_actor_runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN&format=json"

Step 3: Handle Edge Cases

步骤3：处理边缘情况

Comments disabled: Returns 0 — inform user.
Live streams: Comment data may be incomplete for live/premiere videos.
Deleted comments: May appear as empty text strings — filter out rows with
```
text: ""
```
.

评论已禁用：返回0条数据——需告知用户。
直播流：直播或首映视频的评论数据可能不完整。
已删除评论：可能显示为空字符串——需过滤掉
```
text\：""
```
的行。

Output Format

输出格式

undefined

undefined

YouTube Comment Dataset

YouTube评论数据集

Video: <url> | Comments collected: N | Includes replies: YES/NO

Comment ID	Author	Text	Likes	Replies	Timestamp
...	...	...	...	...	...

Available fields: id, authorDisplayName, textDisplay, likeCount, totalReplyCount, publishedAt, isReply, parentId

undefined

视频：<链接>|已收集评论数：N|是否包含回复：是/否

评论ID	作者	内容	点赞数	回复数	时间戳
......	...	......	......min()	......	.......

可用字段：id, authorDisplayName, textDisplay, likeCount, totalReplyCount, publishedAt, isReply, parentId

undefined

Troubleshooting

故障排除

Comments disabled: Creator has turned off comments — cannot be retrieved. Truncated text: YouTube API may truncate very long comments; full text requires reply fetching.

【已禁用：创作者已关闭评论——无法获取。 内容截断：YouTube API可能会截断过长的评论；获取完整内容需要提取回复。",