API local

Documentacao da API

Endpoints para pesquisar, ouvir sem baixar, reproduzir video por stream local, acompanhar jobs e integrar download direto.

FastAPI /docs
POST /api/download-direct

Download direto

Baixa um link ou primeiro resultado de busca e retorna o arquivo como resposta binaria.

{
  "query": "https://www.youtube.com/watch?v=VIDEO_ID",
  "media_format": "mp3",
  "audio_quality": "192",
  "limit": 1,
  "max_duration": 0
}
GET /api/stream/prepare

Audio sem baixar

Prepara uma URL local temporaria para usar em um player audio.

GET /api/stream/prepare?url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DVIDEO_ID

{
  "media_type": "audio/mp4",
  "stream_url": "/api/stream/stream_id"
}
GET /api/video/prepare

Video sem embed

Prepara uma URL local temporaria para usar em um elemento video. A pagina Player usa esta rota.

GET /api/video/prepare?url=https%3A%2F%2Fyoutube.com%2Fwatch%3Fv%3DVIDEO_ID

{
  "media_type": "video/mp4",
  "stream_url": "/api/stream/stream_id"
}

Endpoints principais

Rotas para integrar em outro app.

MetodoEndpointUso
GET/api/healthStatus da API.
POST/api/searchPesquisa YouTube e filtra repetidos.
POST/api/downloadCria job assincrono.
POST/api/download-directRetorna arquivo binario.
GET/api/stream/preparePrepara audio local.
GET/api/video/preparePrepara video local.
GET/api/stream/{id}Stream com Range.
GET/api/jobsLista progresso dos jobs.