discovering-viral-youtube-videos-by-category
Discovers trending and viral YouTube videos by category and country using apidojo's YouTube Trending Scraper on Apify. Triggers when the user asks to: find viral YouTube videos today, discover what's trending on YouTube in a specific country, get trending gaming or music videos on YouTube, find top YouTube videos this week by category, identify viral content on YouTube for inspiration, research what topics are dominating YouTube trending, or track trending YouTube content for content strategy. Returns video title, views, likes, channel info, duration, keywords, and thumbnail. Ideal for content strategists, YouTubers, and trend researchers.
How do I install this agent skill?
npx skills add https://github.com/apidojo-io/apidojo-skills --skill discovering-viral-youtube-videos-by-categoryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill allows discovering YouTube trends via the Apify platform. It includes standard command execution for interacting with APIs and processing results, while also accepting dynamic JavaScript code for data transformation on a remote server. The skill handles external data from YouTube, which presents a surface for indirect prompt injection.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Discovering Viral Youtube Videos By Category
Inputs
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
type | string | Optional | n | Trending category: n (now), music, movies, gaming |
gl | string | Optional | us | Country code (e.g. US, GB) |
hl | string | Optional | en | Language code (e.g. en) |
maxItems | number | Optional | Unlimited | Maximum videos to return |
customMapFunction | string | Optional | — | JavaScript function to transform each output object |
How to Run
Using run_actor.js (recommended)
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'
# Save as CSV
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.csv --format csv
# Save as JSON
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.json --format json
REST API fallback
curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-trending-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'
If Apify MCP is available:
Use the Apify MCP call_actor tool with actor apidojo~youtube-trending-scraper and the input above.
Scoring & Ranking
Score each video by:
views→ normalized 0-1 (cap at 10M), weight 0.40likes→ normalized 0-1 (cap at 500K), weight 0.35recency(trending = 1.0 by definition), weight 0.25
score = 0.40 * min(views / 10000000, 1.0) + 0.35 * min(likes / 500000, 1.0) + 0.25
Classification
| Score | Tier | Label |
|---|---|---|
| ≥ 0.70 | A | MEGA_VIRAL |
| 0.40–0.69 | B | TRENDING |
| < 0.40 | C | RISING |
Edge Cases
- Category not available for country: Some countries only have
n(all). Fall back totype=n. - Stale data: Trending changes throughout the day — data is a snapshot.
- Music/movies category: Returns full songs or trailers — content type differs from regular videos.
- Livestreams in results: isLive=true items are ongoing streams — filter if you need VOD only.
- Country mismatch: gl must be a valid ISO country code (e.g.,
us,gb,de).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/apidojo-io/apidojo-skills/discovering-viral-youtube-videos-by-category">View discovering-viral-youtube-videos-by-category on skillZs</a>