YouTube 📺

Download de vídeos e áudio do YouTube

Obter Informações do Vídeo

GET/api/youtube/info

Retorna metadados do vídeo sem fazer download.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
url	string	Sim	URL do vídeo do YouTube

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/youtube/info?url=https://youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "title": "Rick Astley - Never Gonna Give You Up",
    "author": "Rick Astley",
    "duration": "3:33",
    "views": "1.4B",
    "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "description": "Official video...",
    "upload_date": "2009-10-25"
  }
}

Custo: 10 créditos por requisição

Download de Vídeo/Áudio

POST/api/youtube/download

Faz download do vídeo ou áudio em diversos formatos.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
url	string	Sim	URL do vídeo
format	string	Não	mp4 ou mp3 (padrão: mp4)
quality	string	Não	360p, 480p, 720p, 1080p

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/youtube/download \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "format": "mp4",
    "quality": "720p"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/youtube/download', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://youtube.com/watch?v=dQw4w9WgXcQ',
    format: 'mp4',
    quality: '720p'
  })
});

const data = await response.json();
console.log(data.data.download_url);

Resposta

json

{
  "success": true,
  "message": "Download realizado com sucesso",
  "data": {
    "download_url": "https://storage.alauda.mz/downloads/abc123.mp4",
    "title": "Rick Astley - Never Gonna Give You Up",
    "format": "mp4",
    "quality": "720p",
    "size": "25.4 MB",
    "duration": "3:33",
    "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "credits_remaining": 4950
  }
}

Custo: 50 créditos por download

Formatos e Qualidades

Formatos

•MP4 - Vídeo com áudio
•MP3 - Apenas áudio

Qualidades

•360p - Baixa
•480p - Média
•720p - HD
•1080p - Full HD

⚠️

Limitações

• Tamanho máximo: Vídeos de até 2 horas
• Alguns vídeos com restrições podem não estar disponíveis
• O download pode levar alguns segundos dependendo do tamanho

💡

Dica

Use format: "mp3" para baixar apenas o áudio e economizar créditos e largura de banda.