🎬 YouTube Fast Scraper — Video Metrics & Engagement (No API Key Required)

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Extract complete YouTube video data from channels, playlists, and individual videos: views, likes, comments, duration, hashtags, thumbnails, Shorts detection, and channel info. Powered by yt-dlp with multi-proxy failover. No API key required — optional YouTube Data API v3 enrichment for accurate stats.

✨ Features

• 📺 Channels, Playlists & Videos — Scrape any YouTube URL type (channel, playlist, or single video)
• 📊 Full video metrics — Views, likes, comments count extracted from each video
• ⏱️ Duration & thumbnails — ISO 8601 duration format and high-resolution thumbnail URLs
• 🏷️ Hashtag extraction — From video tags and description text, deduplicated
• 📱 Shorts detection — Automatic identification of YouTube Shorts based on duration, URL, and aspect ratio
• 📝 Subtitle download — Optional auto-generated captions in English and Portuguese
• 🔑 Optional API enrichment — Provide a YouTube Data API v3 key for accurate likes, comments, and subscriber counts
• 🔄 Multi-proxy failover — Residential, Datacenter, Direct strategies tried automatically
• ✅ Contract validation — Every output item validated against a strict data contract before push
• 💰 Pay per result — $0.02/video

📥 Input

Parameter	Type	Required	Default	Description
startUrls	object[]	Yes	—	YouTube URLs (channel, playlist, or video) to scrape
maxItems	integer	No	50	Maximum number of videos to scrape per URL
downloadSubtitles	boolean	No	false	Extract auto-generated captions (EN, PT)
youtubeApiKey	string	No	—	YouTube Data API v3 key for enriched stats (likes, comments, subscribers)

Input Example

{
  "startUrls": [
    { "url": "https://www.youtube.com/@MrBeast" },
    { "url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" },
    { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
  ],
  "maxItems": 20,
  "downloadSubtitles": false
}

📤 Output

Every video includes these fields:

Field	Type	Description
id	string	YouTube video ID
url	string	Full video URL
title	string	Video title
description	string	Video description text
viewCount	integer	Number of views
likes	integer	Number of likes
commentsCount	integer	Number of comments
duration	string	ISO 8601 duration (e.g. PT3M12S)
durationSecs	integer	Duration in seconds
uploadDate	string	Upload date (YYYY-MM-DD)
thumbnail	string	High-resolution thumbnail URL
hashtags	string[]	Tags and hashtags from description
uploader	string	Channel/uploader name
uploaderUrl	string	Channel URL
uploaderFollowers	integer	Channel subscriber count (via API enrichment)
channelId	string	YouTube channel ID
channelVideoCount	integer	Total videos on channel (via API enrichment)
isShort	boolean	Whether the video is a YouTube Short

Output Example

{
  "id": "fC7oUOUEEi4",
  "url": "https://www.youtube.com/watch?v=fC7oUOUEEi4",
  "title": "$456,000 Squid Game In Real Life!",
  "description": "I recreated every single game from Squid Game in real life...",
  "viewCount": 592000000,
  "likes": 18200000,
  "commentsCount": 1400000,
  "duration": "PT25M44S",
  "durationSecs": 1544,
  "uploadDate": "2021-11-24",
  "thumbnail": "https://i.ytimg.com/vi/fC7oUOUEEi4/maxresdefault.jpg",
  "hashtags": ["squidgame", "mrbeast", "challenge"],
  "uploader": "MrBeast",
  "uploaderUrl": "https://www.youtube.com/@MrBeast",
  "uploaderFollowers": 345000000,
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "channelVideoCount": 820,
  "isShort": false
}

📋 Use Cases

• 🎯 Content Strategy — Analyze top-performing videos to inform your content plan
• 🔍 Competitor Research — Track competitor channels, uploads, and engagement rates
• 📈 Trend Analysis — Identify trending topics and formats across channels
• 👥 Influencer Vetting — Evaluate creator metrics (subscribers, avg views, engagement)
• 🏷️ SEO & Keywords — Extract hashtags and tags used by successful videos
• 📱 Shorts vs Long-Form — Compare performance between Shorts and regular videos

❓ FAQ

Q: Do I need a YouTube Data API key? A: No. The actor works without an API key using yt-dlp data extraction. However, providing a YouTube Data API v3 key enables more accurate likes, comments, and subscriber counts via batch API calls.

Q: Does it work with private or age-restricted videos? A: No. The actor can only extract data from publicly accessible videos. Private, unlisted, or age-restricted videos will be skipped.

Q: How does Shorts detection work? A: Videos are classified as Shorts based on multiple signals: duration under 61 seconds, /shorts/ in the URL, #shorts in the title, or vertical aspect ratio (height > width).

Q: Why do some videos have null likes or comments? A: Some creators disable like counts or comments on their videos. The actor reports these as null when the data is not available from YouTube.

Q: Can I scrape entire channels? A: Yes. Provide the channel URL (e.g. https://www.youtube.com/@MrBeast) and the actor will extract videos up to the maxItems limit.

💰 Pricing

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
Per video scraped	$0.02

Example: Scraping 100 videos costs $2.00.

🔗 Related Actors

• TikTok Viral Scanner — TikTok profile & video data
• Instagram Reels Scraper — Instagram metrics
• SEO Intelligence Suite — Full website SEO audit
• Website Change Monitor — Track page changes

📝 Changelog

v1.3 (Current)

• YouTube Data API v3 enrichment for accurate likes/comments/subscribers
• Batch API calls (50 videos per request) for efficiency
• Channel statistics lookup (subscriber count, video count)
• Graceful fallback — API key optional, yt-dlp data used if no key
• PPE billing via Actor.charge()

v1.2

• Residential proxy via --proxy flag (YouTube blocks datacenter IPs)
• Multi-strategy: proxy residential, datacenter, direct
• Full video data via --dump-json (description, likes, comments, hashtags)
• YouTube Shorts detection
• Contract validation on all output items

v1.0

• Channel, playlist, and video URL scraping
• yt-dlp powered extraction
• View count, duration, thumbnail, uploader info

---

🎬 YouTube Fast Scraper — Métricas de Vídeos e Engajamento (Sem API Key)

🇺🇸 English | 🇧🇷 Português

Extraia dados completos de vídeos do YouTube de canais, playlists e vídeos individuais: visualizações, curtidas, comentários, duração, hashtags, thumbnails, detecção de Shorts e informações do canal. Alimentado por yt-dlp com failover multi-proxy. Sem necessidade de API key — enriquecimento opcional com YouTube Data API v3 para estatísticas precisas.

✨ Funcionalidades

• 📺 Canais, Playlists e Vídeos — Extraia dados de qualquer tipo de URL do YouTube (canal, playlist ou vídeo individual)
• 📊 Métricas completas — Visualizações, curtidas e contagem de comentários extraídos de cada vídeo
• ⏱️ Duração e thumbnails — Formato de duração ISO 8601 e URLs de thumbnails em alta resolução
• 🏷️ Extração de hashtags — De tags do vídeo e texto da descrição, sem duplicatas
• 📱 Detecção de Shorts — Identificação automática de YouTube Shorts baseada em duração, URL e proporção de tela
• 📝 Download de legendas — Legendas auto-geradas opcionais em inglês e português
• 🔑 Enriquecimento opcional via API — Forneça chave da YouTube Data API v3 para curtidas, comentários e inscritos precisos
• 🔄 Failover multi-proxy — Estratégias Residencial, Datacenter e Direto tentadas automaticamente
• ✅ Validação de contrato — Cada item de saída validado contra contrato de dados rigoroso antes do push
• 💰 Pague por resultado — $0.02/vídeo

📥 Entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
startUrls	object[]	Sim	—	URLs do YouTube (canal, playlist ou vídeo) para extrair
maxItems	inteiro	Não	50	Número máximo de vídeos para extrair por URL
downloadSubtitles	boolean	Não	false	Extrair legendas auto-geradas (EN, PT)
youtubeApiKey	string	Não	—	Chave da YouTube Data API v3 para estatísticas enriquecidas (curtidas, comentários, inscritos)

Exemplo de Entrada

{
  "startUrls": [
    { "url": "https://www.youtube.com/@MrBeast" },
    { "url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" },
    { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
  ],
  "maxItems": 20,
  "downloadSubtitles": false
}

📤 Saída

Cada vídeo inclui estes campos:

Campo	Tipo	Descrição
id	string	ID do vídeo no YouTube
url	string	URL completa do vídeo
title	string	Título do vídeo
description	string	Texto da descrição
viewCount	inteiro	Número de visualizações
likes	inteiro	Número de curtidas
commentsCount	inteiro	Número de comentários
duration	string	Duração ISO 8601 (ex: PT3M12S)
durationSecs	inteiro	Duração em segundos
uploadDate	string	Data de upload (AAAA-MM-DD)
thumbnail	string	URL da thumbnail em alta resolução
hashtags	string[]	Tags e hashtags da descrição
uploader	string	Nome do canal/uploader
uploaderUrl	string	URL do canal
uploaderFollowers	inteiro	Número de inscritos do canal (via enriquecimento API)
channelId	string	ID do canal no YouTube
channelVideoCount	inteiro	Total de vídeos no canal (via enriquecimento API)
isShort	boolean	Se o vídeo é um YouTube Short

Exemplo de Saída

{
  "id": "fC7oUOUEEi4",
  "url": "https://www.youtube.com/watch?v=fC7oUOUEEi4",
  "title": "$456,000 Squid Game In Real Life!",
  "description": "I recreated every single game from Squid Game in real life...",
  "viewCount": 592000000,
  "likes": 18200000,
  "commentsCount": 1400000,
  "duration": "PT25M44S",
  "durationSecs": 1544,
  "uploadDate": "2021-11-24",
  "thumbnail": "https://i.ytimg.com/vi/fC7oUOUEEi4/maxresdefault.jpg",
  "hashtags": ["squidgame", "mrbeast", "challenge"],
  "uploader": "MrBeast",
  "uploaderUrl": "https://www.youtube.com/@MrBeast",
  "uploaderFollowers": 345000000,
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "channelVideoCount": 820,
  "isShort": false
}

📋 Casos de Uso

• 🎯 Estratégia de conteúdo — Analise vídeos de melhor desempenho para planejar seu conteúdo
• 🔍 Pesquisa de concorrentes — Acompanhe canais, uploads e taxas de engajamento dos concorrentes
• 📈 Análise de tendências — Identifique tópicos e formatos em alta entre canais
• 👥 Avaliação de influenciadores — Avalie métricas de criadores (inscritos, média de views, engajamento)
• 🏷️ SEO e palavras-chave — Extraia hashtags e tags usadas por vídeos de sucesso
• 📱 Shorts vs longa duração — Compare performance entre Shorts e vídeos regulares

❓ Perguntas Frequentes

P: Preciso de uma chave da YouTube Data API? R: Não. O actor funciona sem chave de API usando extração de dados via yt-dlp. Porém, fornecer uma chave da YouTube Data API v3 permite curtidas, comentários e contagem de inscritos mais precisos através de chamadas em lote.

P: Funciona com vídeos privados ou com restrição de idade? R: Não. O actor só consegue extrair dados de vídeos acessíveis publicamente. Vídeos privados, não listados ou com restrição de idade serão ignorados.

P: Como funciona a detecção de Shorts? R: Vídeos são classificados como Shorts com base em múltiplos sinais: duração abaixo de 61 segundos, /shorts/ na URL, #shorts no título ou proporção vertical (altura > largura).

P: Por que alguns vídeos têm curtidas ou comentários nulos? R: Alguns criadores desabilitam contagem de curtidas ou comentários em seus vídeos. O actor reporta esses valores como null quando os dados não estão disponíveis no YouTube.

P: Posso extrair canais inteiros? R: Sim. Forneça a URL do canal (ex: https://www.youtube.com/@MrBeast) e o actor extrairá vídeos até o limite definido em maxItems.

💰 Preços

Este actor usa precificação Pay Per Event (PPE):

Métrica	Custo
Por vídeo extraído	$0.02

Exemplo: Extrair 100 vídeos custa $2.00.

🔗 Actors Relacionados

• TikTok Viral Scanner — Dados de perfis e vídeos do TikTok
• Instagram Reels Scraper — Métricas do Instagram
• SEO Intelligence Suite — Auditoria SEO completa
• Website Change Monitor — Monitoramento de mudanças

📝 Changelog

v1.3 (Atual)

• Enriquecimento via YouTube Data API v3 para curtidas/comentários/inscritos precisos
• Chamadas API em lote (50 vídeos por requisição) para eficiência
• Consulta de estatísticas do canal (contagem de inscritos e vídeos)
• Fallback gracioso — chave de API opcional, dados do yt-dlp usados se sem chave
• Cobrança PPE via Actor.charge()

v1.2

• Proxy residencial via flag --proxy (YouTube bloqueia IPs de datacenter)
• Multi-estratégia: proxy residencial, datacenter, direto
• Dados completos de vídeo via --dump-json (descrição, curtidas, comentários, hashtags)
• Detecção de YouTube Shorts
• Validação de contrato em todos os itens de saída

v1.0

• Extração de URLs de canal, playlist e vídeo
• Extração alimentada por yt-dlp
• Contagem de views, duração, thumbnail, info do uploader