🚀 iniciando :

clone o projeto:

git clone https://github.com/JonasCaetanoSz/api-youtube-download.git

satisfazendo os requisitos :

cd api-youtube-download && pip3 install -r requirements.txt

variveis de ambiente (opcional):

para coletar a imagem do album, nome do artista é nome do album foi utilizado a API do genius, para usar ela é preciso ter um token de acesso que você pode obter cadastrando como desenvolvedor em genius API clients é gratuito e rapido de fazer. com seu token de acesso em mãos você deve criar uma variavel de ambiente:

a chave deve ser : CLIENT_ACCESS_TOKEN é receber como valor seu token de acesso obtido no genius.

você não precisar usar a API do genius basta fazer essa variavel receber um valor aleatorio para não quebrar o codigo porém, os metadados da musica serão pegos diretamente do youtube é a capa do album ou single estará em qualidade inferior.

iniciando a aplicação:

python api/main.py

📚 documentação :

buscando por vídeos:

Para buscar por vídeos use :

 /search?keyword="título do vídeo"

retorna o resultado de pesquisa do youtube:

Para limitar o máximo de resultados:

 /search?keyword="título do video"&max_results= máximo de resultados desejado.

nota : O parâmetro max_results é opcional, se não for pasado recebe 10 como seu valor padrão.

obter resoluções disponíveis:

Para obter use a rota resolutions:

/resolutions?url_surfix="url surfix do video"

retorna as resoluções disponiveis :

obtendo informações do vídeo:

Para obter informações como duração do vídeo, título do vídeo, thumbnail do vídeo é a url_surfix passada use:

/details?url_surfix="url surfix do vídeo"

retorna as informações do video :

baixando vídeos:

Para baixar vídeos você precisa informar 3 parâmetros obrigatórios, são eles:

• url_surfix : url surfix do vídeo.

• format : formato para download pode receber áudio ou vídeo.

• resolution : qualidade do download se for vídeo envie a resolução + P se for áudio envie a qualidade + kbps .

Exemplos:

Baixar o áudio :

/download?url_surfix="/watch?v=-ObdvMkCKws"&format=audio&resolution=160kbps

Baixar o vídeo :

/download?url_surfix="/watch?v=-ObdvMkCKws"&format=video&resolution=360p

retorna o link para download do arquivo:

⚠️ aviso :

Este é um projeto criado apenas para estudo, portanto não me responsabilizo por nenhum uso indevido ou ato que seja contra os termos de serviço do Youtube.