finding-youtube-channels-by-growth-rate

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Finding Youtube Channels By Growth Rate

按增长率查找YouTube频道

Executes finding youtube channels by growth rate using apidojo scrapers. Part of the apidojo intelligence skills library.

使用apidojo爬虫执行按增长率查找YouTube频道的操作，属于apidojo智能技能库的一部分。

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 URL — 频道、播放列表、Shorts、搜索结果
`youtubeHandles`	array	可选	`[]`	YouTube频道标识（例如 `@kurzgesagt` ）
`getTrending`	boolean	可选	`false`	获取热门视频
`keywords`	array	可选	`[]`	搜索关键词
`gl`	string	可选	`us`	结果对应的国家代码（例如 `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: Define parameters
- [ ] Step 2: Run youtube-scraper
- [ ] Step 3: Filter and classify results
- [ ] Step 4: Score by quality and relevance
- [ ] Step 5: Deliver output

进度：
- [ ] 步骤1：定义参数
- [ ] 步骤2：运行youtube-scraper
- [ ] 步骤3：筛选并分类结果
- [ ] 步骤4：按质量和相关性评分
- [ ] 步骤5：交付输出

Step 2: Run the Actor

步骤2：运行Actor

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

bash

undefined

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

bash

undefined

Quick answer (prints table to chat)

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

Save as CSV

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

Save as JSON

node scripts/run_actor.js
--actor "apidojo~youtube-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-scraper" Input: { "searchTerms": "[NICHE] channel", "[NICHE] YouTube", "maxItems": 100 }


**REST API fallback:**
```bash
curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~youtube-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": "[NICHE] channel", "[NICHE] YouTube", "maxItems": 100}'

Wait for

SUCCEEDED

. Fetch dataset:

bash

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

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

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

**如果Apify MCP可用：**

Tool: apify:run-actor Actor: "apidojo~youtube-scraper" Input: { "searchTerms": "[NICHE] channel", "[NICHE] YouTube", "maxItems": 100 }


**REST API备选方案：**
```bash
curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~youtube-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": "[NICHE] channel", "[NICHE] YouTube", "maxItems": 100}'

等待任务状态变为

SUCCEEDED

。获取数据集：

bash

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

Step 3: Classify Results

步骤3：分类结果

classification: ACCELERATING (growth > 50% MoM) | GROWING (10-50% MoM) | STEADY (0-10%) | DECLINING (negative)

分类标准：ACCELERATING（月增长率>50%）| GROWING（月增长率10-50%）| STEADY（月增长率0-10%）| DECLINING（负增长）

Step 4: Score Each Result

步骤4：为每个结果评分

score = growth_signal = (recent_views_avg / older_views_avg) - 1  # momentum ratio; > 0 = accelerating

score = growth_signal = (recent_views_avg / older_views_avg) - 1  # 势头比率；>0表示增长加速

Step 5: Edge Cases

步骤5：边缘情况

Subscriber count is a lagging indicator — use view velocity (views per day on recent videos) as the leading indicator of current growth

Additional fallbacks:

< 20 results: Broaden search terms; remove secondary filters
No results: Verify the search terms are correct; try alternate phrasings
Data quality issues: Remove entries with missing key fields; note count in output

订阅量是滞后指标——使用观看速度（近期视频的日均观看量）作为当前增长的领先指标

其他备选方案：

结果少于20条：扩大搜索词范围；移除次要筛选条件
无结果：验证搜索词是否正确；尝试其他表述方式
数据质量问题：移除缺少关键字段的条目；在输出中注明数量

Output Format

输出格式

undefined

undefined

Finding Youtube Channels By Growth Rate

按增长率查找YouTube频道

Results: [N] | Date: [DATE]

#	[Key Field]	[Metric 1]	[Metric 2]	[Classification]	[Score]
1	[value]	[value]	[value]	[type]	[0.XX]

结果数量：[N] | 日期：[DATE]

序号	[关键字段]	[指标1]	[指标2]	[分类]	[评分]
1	[数值]	[数值]	[数值]	[类型]	[0.XX]

Summary

总结

Top result: [description] Key finding: [insight]

undefined

最优结果：[描述] 关键发现：[洞察]

undefined

Troubleshooting

故障排除

Too few results: Broaden the primary search term; remove restrictive filters. Low quality results: Apply minimum score threshold (≥ 0.50) to filter noise. Actor fails to run: Verify API key; check actor status at apify.com/apidojo.

结果过少：扩大核心搜索词范围；移除限制性筛选条件。 结果质量低：应用最低评分阈值（≥0.50）过滤无效数据。 Actor运行失败：验证API密钥；在apify.com/apidojo查看Actor状态。