Instalação

npm install iguro-ytdl

Funções

| Função | Descrição | |--------|-----------| | ytmp3(url) | Retorna link de download de áudio (MP3) de uma URL do YouTube | | ytmp4(url, quality?) | Retorna link de download de vídeo (MP4) de uma URL do YouTube | | ytplay(query) | Aceita URL ou termo de busca e retorna links de MP3 + MP4 |

Como usar

const { ytmp3, ytmp4, ytplay } = require("iguro-ytdl");

ytmp3(url)

Retorna informações de download de áudio para uma URL do YouTube.

const resultado = await ytmp3("https://www.youtube.com/watch?v=MI9ZpIKgyf0");
console.log(resultado);

Resposta:

{
  "status": true,
  "result": {
    "title": "Ed Sheeran - Azizam (Official Music Video)",
    "channel": "Ed Sheeran",
    "views": "44.8M",
    "thumbnail": "https://i.ytimg.com/vi/MI9ZpIKgyf0/sddefault.jpg",
    "duration": "03:27",
    "quality": "128kbps",
    "url": "https://cdn.savetube.vip/media/..."
  }
}

ytmp4(url, quality?)

Retorna informações de download de vídeo. O parâmetro quality é opcional (padrão: melhor qualidade disponível).

Qualidades aceitas: "144p", "240p", "360p", "480p", "720p", "1080p", "FHD", etc.

const resultado = await ytmp4("https://www.youtube.com/watch?v=MI9ZpIKgyf0", "1080p");
console.log(resultado);

Resposta:

{
  "status": true,
  "result": {
    "title": "Ed Sheeran - Azizam (Official Music Video)",
    "channel": "Ed Sheeran",
    "views": "44.8M",
    "thumbnail": "https://i.ytimg.com/vi/MI9ZpIKgyf0/sddefault.jpg",
    "duration": "00:03:27",
    "quality": "FHD",
    "size": "30.12 MB",
    "url": "https://rr2---sn-....googlevideo.com/videoplayback/...",
    "worker": "https://s21.worker03.com/v5/video/..."
  }
}

ytplay(query)

Aceita uma URL do YouTube ou um termo de busca. Retorna metadados e links de download em MP3 e MP4, além de todos os formatos disponíveis.

// Com URL
const resultado = await ytplay("https://www.youtube.com/watch?v=MI9ZpIKgyf0");

// Com termo de busca
const resultado = await ytplay("Ed Sheeran Azizam");

console.log(resultado);

Resposta:

{
  "status": true,
  "result": {
    "title": "Ed Sheeran - Azizam (Official Music Video)",
    "channel": "Ed Sheeran",
    "views": "44.8M",
    "thumbnail": "https://i.ytimg.com/vi/MI9ZpIKgyf0/sddefault.jpg",
    "duration": "03:27",
    "url": "https://www.youtube.com/watch?v=MI9ZpIKgyf0",
    "download": {
      "mp3": "https://cdn.savetube.vip/media/....mp3",
      "mp4": "https://rr2---sn-....googlevideo.com/videoplayback/..."
    },
    "formats": {
      "mp3": [],
      "mp4": []
    }
  }
}

Tratamento de erros

Todas as funções retornam um formato de resposta consistente. Em caso de falha, status será false e error conterá a mensagem:

{
  "status": false,
  "error": "Algo deu errado"
}

Sempre verifique result.status antes de usar os dados:

const res = await ytmp3("https://www.youtube.com/watch?v=...");
if (!res.status) {
  console.error("Erro:", res.error);
} else {
  console.log("URL de download:", res.result.url);
}

Dependências

• axios

Licença

MIT © Anonimo.js