apidojo-io/apidojo-skills

discovering-viral-youtube-videos-by-category

Discovers trending and viral YouTube videos by category and country using apidojo's YouTube Trending Scraper on Apify.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/apidojo-io/apidojo-skills --skill discovering-viral-youtube-videos-by-category

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

Discovering Viral Youtube Videos By Category


Inputs

ParameterTypeRequiredDefaultNotes
typestringOptionalnTrending category: n (now), music, movies, gaming
glstringOptionalusCountry code (e.g. US, GB)
hlstringOptionalenLanguage code (e.g. en)
maxItemsnumberOptionalUnlimitedMaximum videos to return
customMapFunctionstringOptional—JavaScript function to transform each output object

How to Run

Using run_actor.js (recommended)

bash
# 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

bash
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.40
  • likes → normalized 0-1 (cap at 500K), weight 0.35
  • recency (trending = 1.0 by definition), weight 0.25
python
score = 0.40 * min(views / 10000000, 1.0) + 0.35 * min(likes / 500000, 1.0) + 0.25

Classification

ScoreTierLabel
≥ 0.70AMEGA_VIRAL
0.40–0.69BTRENDING
< 0.40CRISING

Edge Cases

  • Category not available for country: Some countries only have n (all). Fall back to type=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).

Relacionados por tarefa

do mesmo repositório

Mais Skills

Todos os Skills
apidojo-io
Comunidade

discovering-tiktok-creators-by-niche

Discovers and ranks TikTok creators in any niche or topic using apidojo's TikTok scrapers on Apify. Triggers when the user asks to: find TikTok influencers in a specific niche, discover creators for a campaign, identify who's growing fastest on TikTok in a category, find micro-influencers on TikTok under a certain follower count, build a list of TikTok creators for brand partnerships, compare TikTok creator engagement rates in a vertical, or identify rising TikTok stars. Returns creator username

Instalações / 1h
2
GitHub Stars
1
Atualizado
13 de mai.
apidojo-io
Comunidade

finding-gaming-content-creators

Finds gaming content creators on TikTok and YouTube using apidojo's scrapers on Apify. Triggers when the user asks to: find gaming influencers for brand campaigns, discover streamers or gaming YouTubers in a specific game or genre, find TikTok creators posting gaming content, identify gaming micro-influencers for product sponsorships, find gaming creators who review hardware or accessories, build a gaming creator outreach list for a gaming brand or peripheral company, or discover rising gaming c

Instalações / 1h
2
GitHub Stars
1
Atualizado
13 de mai.
apidojo-io
Comunidade

scraping-instagram-posts-by-hashtag

Scrapes Instagram posts for any hashtag using apidojo's Instagram scraper on Apify. Triggers when the user asks to: get Instagram posts for a hashtag, scrape Instagram content by tag, export Instagram post data for a keyword or topic, fetch posts under an Instagram challenge or trend, collect Instagram media for a specific tag, or download Instagram post metadata by hashtag. Returns post URL, caption, like count, comment count, author handle, and timestamp per post. Ideal for trend analysts, UGC

Instalações / 1h
2
GitHub Stars
1
Atualizado
13 de mai.
apidojo-io
Comunidade

scraping-tiktok-profile-data

Scrapes TikTok profile statistics and metadata for any list of accounts using apidojo's TikTok Profile scraper on Apify. Triggers when the user asks to: get TikTok profile stats for an account, fetch follower count and engagement data for TikTok users, scrape TikTok account metadata in bulk, export TikTok profile information for a list of creators, check TikTok stats for multiple usernames, or get bio and follower data from TikTok profiles. Returns username, follower count, following count, tota

Instalações / 1h
1
GitHub Stars
1
Atualizado
13 de mai.