REST API completa para download de vídeo/áudio do YouTube, Blogger e 1100+ sites via yt-dlp — com progresso em tempo real (SSE) e link pronto para compartilhar.
https://yt-api.zero-two-apis.store
· ← Painel interativo (testar rotas ao vivo)
· /sites — plataformas suportadas
Use sua própria apikey para pesquisar e reproduzir músicas, vídeos, lives e playlists com player moderno, notificações e reprodução em segundo plano.
O download atual é para Android. Uma versão iOS pública exige macOS/Xcode e Apple Developer Program.
Quase todas as rotas exigem uma API key. Passe como query param apikey em qualquer chamada:
GET /audio?url=https://www.youtube.com/watch?v=XXXX&apikey=SUA_KEY
Rotas públicas (não pedem key): /, /docs, /health, /meta, /stats, /detailed-stats, /deps, /endpoints, /config/site, /sites, /cleanup-stats.
# Áudio do YouTube direto para arquivo curl "https://yt-api.zero-two-apis.store/audio?url=https://www.youtube.com/watch?v=146RCHTZld4&apikey=SUA_KEY" -H "Accept: application/json" # Vídeo do Instagram (SSE — veja a seção de streaming) curl -N "https://yt-api.zero-two-apis.store/instagram?url=https://www.instagram.com/reel/C7XYZabc123/&apikey=SUA_KEY"
const r = await fetch( `https://yt-api.zero-two-apis.store/extract/info?url=${encodeURIComponent(url)}&apikey=SUA_KEY` ); const json = await r.json(); if (json.status) console.log(json.resultados.title, json.resultados.formats.best_progressive?.url);
const axios = require('axios'); const { data: stream } = await axios.get( 'https://yt-api.zero-two-apis.store/shorts', { params: { url: 'https://youtube.com/shorts/146RCHTZld4', apikey: 'SUA_KEY' } } ); // /shorts responde JSON único: console.log(stream.resultados.direct); // https://...mp4 (link de download)
import requests r = requests.get('https://yt-api.zero-two-apis.store/info', params={ 'url': 'https://www.youtube.com/watch?v=146RCHTZld4', 'apikey': 'SUA_KEY' }, timeout=60) data = r.json() print(data['resultados']['title'])
$ch = curl_init('https://yt-api.zero-two-apis.store/extract/info?url=' . urlencode('https://www.tiktok.com/@user/video/7123...') . '&apikey=SUA_KEY'); curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60]); $json = json_decode(curl_exec($ch), true); curl_close($ch); echo $json['resultados']['title'];
As rotas de processamento pesado respondem Content-Type: text/event-stream e enviam eventos data: {...}\n\n de progresso até o evento final padronizado (que contém o link) — ou um evento com status: "error" em caso de falha.
Formato final padronizado de TODAS as rotas de download (/download, /extract/download, aliases, /video/mp4, /sponsorblock, /multi-stream, /external-downloader, /download-sections, /split-chapters):
{
"status": "completed",
"done": true,
"criador": "@lucas_mod_domina",
"resultados": { "url": "https://...", "title": "...", "size": "...", "...": "campos variam por rota" }
}
As rotas de playlist em lote (/playlist/audio, /playlist/video) seguem padrão próprio: um evento por item (completed/ready com url no topo) e encerram com { "status"/"type": "done", "done": true, ... }.
Rotas SSE: /download, /download-sections, /split-chapters, /sponsorblock, /multi-stream, /external-downloader, /video/mp4, /playlist/audio, /playlist/video, /extract/download e os aliases de plataforma (/instagram, /tiktok…).
const res = await fetch(url_com_apikey); const reader = res.body.pipeThrough(new TextDecoderStream()).getReader(); let buf = ''; while (true) { const { value, done } = await reader.read(); if (done) break; buf += value; const evts = buf.split('\n\n'); buf = evts.pop(); // resto incompleto espera o próximo chunk for (const e of evts) { if (!e.startsWith('data: ')) continue; const evt = JSON.parse(e.slice(6)); if (evt.status === 'completed') console.log('LINK:', evt.resultados?.url || evt.url); else if (evt.status === 'error') console.error(evt.error); else console.log(evt.progress, evt.status); // progresso } }
import requests, json with requests.get(url, params={...}, stream=True, timeout=600) as r: for line in r.iter_lines(decode_unicode=True): if line and line.startswith('data: '): evt = json.loads(line[6:]) if evt.get('status') == 'completed': print('LINK:', (evt.get('resultados') or {}).get('url') or evt.get('url'))
completed.Rotas JSON seguem o padrão:
{
"status": true,
"criador": "@lucas_mod_domina",
"resultados": { ... }
}
Em erro: {"status": false, "error": "...", "message": "..."} (HTTP 4xx/5xx). O evento SSE final traz resultados.url (link de download), resultados.expires (validade do link) e resultados.uploadedTo (Catbox · Litterbox · Dropbox · Gofile · local).
| Rota | Params | Resposta |
|---|---|---|
GET /info | url | Metadados completos do vídeo |
GET /formats | url | Lista bruta de formatos (yt-dlp --list-formats) |
GET /audio | url | JSON com link direto do melhor áudio |
GET /audio/mp3 | url | Arquivo MP3 (128k, compatível c/ WhatsApp) — download direto |
GET /audio/pipe | url | Stream binário do áudio (m4a/webm) |
GET /video | url | Vídeo muxado; upload e link |
GET /video/mp4 SSE | url | Re-encode alta qualidade (H.264 CRF18) |
GET /short · /shorts | url | Short em MP4 H.264/AAC + link (cache 6h) |
GET /live | url, from_start | URL HLS/stream da live |
GET /shorts?url=https://youtube.com/shorts/146RCHTZld4&apikey=SUA_KEY
{
"status": true,
"resultados": {
"direct": "https://gofile.io/d/trU950",
"expires": "Temporário (Página de Download)",
"filename": "short_1786432811370_wc7ecouvm9q.mp4",
"title": "ele achou que era Malandro... 😂",
"resolution_original": "1080x1920"
}
}
Funcionam com qualquer site suportado pelo yt-dlp — Instagram, TikTok, Twitter/X, Facebook, Pinterest, Kwai, Reddit, Twitch, Vimeo, SoundCloud, Dailymotion e centenas mais (lista completa em /sites).
| Rota | Params | Resposta |
|---|---|---|
GET /extract/info | url | Metadados + melhores formatos de qualquer site |
GET /extract/download SSE | url, quality, format | Download universal + link |
GET /sites pública | — | Extratores suportados (1100+) + destaques |
| GET aliases SSE | /instagram · /tiktok · /twitter · /facebook · /pinterest · /kwai · /reddit · /twitch · /vimeo · /soundcloud · /dailymotion — mesmos params de /extract/download | |
Params de download: quality = best (padrão) · 1080p · 720p · 480p · 360p · worst | format = mp4 (padrão) · mp3 (só o áudio)
GET /tiktok?url=https://www.tiktok.com/@usuario/video/7234567890123456789&format=mp3&apikey=SUA_KEY
# eventos SSE:
data: {"progress":5,"status":"Plataforma detectada: TikTok"}
data: {"progress":15,"status":"Baixando melhor áudio..."}
data: {"progress":92,"status":"[UPLOAD] ✓ Gofile — https://gofile.io/d/xxxxx"}
data: {"status":"completed","done":true,"criador":"@lucas_mod_domina","resultados":{"url":"https://gofile.io/d/xxxxx","size":"2.9 MB","platform":"TikTok","format":"mp3"}}
Extrator dedicado (yt-dlp PR #17129, rodando via Python local — veja /deps → ytdlp_blogger). Aceita tanto blogger.com/video.g?token=... quanto posts de blog com vídeo embutido.
| Rota | Params | Resposta |
|---|---|---|
GET /blogger/info | url | Metadados + melhor link progressivo |
GET /blogger/download | url, quality, format | Download (mp4/mp3) + link |
GET /blogger/download?url=https://blog.tomeuvizoso.net/2019/01/a-panfrost-milestone.html&quality=720p&apikey=SUA_KEY
| Rota | Params principais | O que faz |
|---|---|---|
GET /download | url, quality, format, extractAudio, audioFormat, limitRate... | Download universal do YouTube com todas as opções |
GET /download-sections | url, sections (ex.: *10:15-15:30) | Baixa só trechos do vídeo |
GET /split-chapters | url | Divide o vídeo em capítulos |
GET /sponsorblock | url, mark ou remove (ex.: sponsor,intro,outro) | Remove/marca propaganda automaticamente |
GET /multi-stream | url... | Combina múltiplos streams |
GET /external-downloader | url, downloader (aria2c...), concurrentFragments | Usa downloader externo p/ máxima velocidade |
GET /dl | url, type? | Legado: auto-detecta vídeo/áudio/short |
# Só o trecho 1:00–2:30 de um vídeo GET /download-sections?url=...§ions=*1:00-2:30&apikey=SUA_KEY # Vídeo limpo sem publicidade nem intro GET /sponsorblock?url=...&remove=sponsor,intro,outro&apikey=SUA_KEY
| Rota | Params | Resposta |
|---|---|---|
GET /playlist/info | url | Metadados + itens (título, duração, thumbs) |
GET /playlist/audio SSE | url, audioFormat... | Link de áudio por item, emitido em tempo real |
GET /playlist/video SSE | url | URL pronta de /video por item |
| Rota | Params | Resposta |
|---|---|---|
GET /api/ytsrc | q (ou query) | Vídeos, canais e playlists encontrados |
GET /api/ytsrc/videos | q | Apenas vídeos |
GET /api/ytsrc?q=lofi%20hip%20hop&apikey=SUA_KEY → { status: true, resultado: [ { title, url, duration ... }, ... ] }
| Rota | Resposta |
|---|---|
GET /health | online + horário BRT |
GET /meta | runtime: ffmpeg/yt-dlp/cloudflared/blogger/memória |
GET /deps | versões e status de cada dependência + análise de cookies |
GET /stats · /detailed-stats | métricas de uso |
GET /endpoints | esta lista de rotas em JSON (o painel consome daqui) |
// npm i @whiskeysockets/baileys axios if (text.startsWith('!play ')) { const q = text.slice(6); const s = await axios.get('https://yt-api.zero-two-apis.store/api/ytsrc', { params: { q, apikey } }); const v = s.data.resultado.videos[0]; const a = await axios.get('https://yt-api.zero-two-apis.store/audio/mp3', { params: { url: v.url, apikey }, responseType: 'arraybuffer' }); await sock.sendMessage(jid, { audio: Buffer.from(a.data), mimetype: 'audio/mpeg' }); }
const { data } = await axios.get('https://yt-api.zero-two-apis.store/extract/info', { params: { url: linkDoUsuario, apikey: process.env.YTDL_KEY } }); await interaction.reply( `🎬 ${data.resultados.title}\n⬇️ ${data.resultados.formats.best_progressive?.url ?? 'sem progressivo — use /extract/download'}` );
| Erro | Causa / solução |
|---|---|
401 API key inválida | Key errada, esgotada ou excluída por 30 dias de inatividade |
429 RATE_LIMIT | Máx. 120 req/min por IP — aguarde 1 minuto |
verificação anti-bot / 403 | Cookies do servidor expiraram — o admin reexporta o cookies.txt |
A plataforma pediu login | Post privado/protegido (Instagram/TikTok): requer cookies daquela rede no servidor |
Conteúdo indisponível | Vídeo removido, privado ou região bloqueada |
Timeout (504) | Mídia muito longa/pesada — tente quality=360p ou uma rota mais leve |
/extract/info antes do download para confirmar título/duração. 2) Links de upload temporários (Litterbox 24h, Gofile ~dias) — baixe o arquivo logo após receber. 3) Em SSE, consuma até o evento completed; desconectar antes cancela o processamento no servidor. 4) Playlists grandes (100+ itens) levam vários minutos em /playlist/audio — considere processar itens individualmente.cookies.txt (decisão upstream, não há mais cliente anônimo).cookies.txt. Em servidores com IP de datacenter o Instagram responde 429 Too Many Requests mesmo com cookies — nesse caso, só via proxy residencial ou IP "limpo".cookies.txt (a API analisa e avisa no boot e em /deps).POST /admin/pot/update; trave a versão com YTDLP_POT_VERSION ou desative com POT_AUTO_UPDATE=0). Cookies seguem necessários apenas para: restrição de idade, conteúdo de membros/privado e Instagram/TikTok. Acompanhe em /deps (pot_provider e js_runtime).Rotas de manutenção do servidor, protegidas por token de admin. Ative definindo ADMIN_TOKEN=uma-senha-forte no .env e reinicie. Sem a variável, as rotas respondem 503. Autentique via header Authorization: Bearer <TOKEN> ou query ?token=<TOKEN>.
| Rota | Descrição |
|---|---|
GET /admin/cookies/status | Estado dos cookies: total, expirados, expirando em 7 dias, sessão autenticada?, domínios cobertos e dias até o vencimento mais próximo. |
POST /admin/cookies/refresh | Troca o cookies.txt em produção sem restart. Aceita o arquivo Netscape (cookies.txt) ou o JSON da extensão "Get cookies.txt LOCALLY" — detecta e converte automaticamente. Faz backup do arquivo anterior (cookies.txt.bak-*), valida antes de aplicar e rejeita arquivos sem nenhum cookie válido. |
curl -X POST "https://yt-api.zero-two-apis.store/admin/cookies/refresh" \ -H "Authorization: Bearer SUA_SENHA_ADMIN" \ -H "Content-Type: text/plain" \ --data-binary @cookies.txt
--data-binary (não -d) e o header Content-Type: text/plain para preservar os tabs do formato Netscape. Para mandar o JSON da extensão, use Content-Type: application/json.curl "https://yt-api.zero-two-apis.store/admin/cookies/status?token=SUA_SENHA_ADMIN"
yt-cookies do PyPI): eles baixam cookies de sessão de contas de pessoas desconhecidas vindos de um servidor remoto — risco de fraude, banimento da sua VPS e vazamento de dados. O correto é exportar os seus cookies do seu navegador e enviar por esta rota, ou deixar o PO Token provider cuidar do anti-bot automaticamente.