For the complete documentation index, see llms.txt. This page is also available as Markdown.

Baixador

Baixe conteúdo de áudio e vídeo do YouTube pelo ID do vídeo, com qualidade de vídeo configurável até 8K, entregue diretamente ao seu armazenamento em nuvem.

O youtube_download a fonte fornece o conteúdo de áudio/vídeo de um vídeo do YouTube de sua escolha. Observe que, devido ao potencialmente grande volume de dados, essa fonte está disponível apenas por meio da integração assíncrona integração Push-Pull e o armazenamento em nuvem recurso.

Como funciona o YouTube Downloader

  1. Enviar via API:

    • Um ou mais IDs de vídeo do YouTube;

    • Detalhes do armazenamento em nuvem.

  2. Obtenha a resposta da API com a confirmação de que sua solicitação para baixar um vídeo foi aceita com sucesso.

  3. Obtenha os vídeos no local de armazenamento em nuvem especificado assim que forem processados pelo nosso sistema.

Valores dos parâmetros de entrada

Parâmetro
Descrição
Valor padrão

source

Define o scraper. Use youtube_download.

query

ID do vídeo do YouTube.

storage_type

Tipo de armazenamento do serviço em nuvem (gcs, s3 ou s3_compatible)

storage_url

O nome do bucket (para AWS S3) ou a URL (para outros armazenamentos compatíveis com S3) do local de armazenamento em nuvem para o qual você gostaria que o resultado fosse enviado.

callback_url

A URL do seu endpoint de callback. Mais informações

contexto: download_type

Especifica se deve baixar audio, video, ou ambos - audio_video.

audio_video

contexto: video_quality

Define a qualidade do vídeo: best, worst, ou uma resolução: 144, 360, 480, 720, 1080, 1440, 2160(4K), 4320(8K).

720

context: audio_language

Especifica qual faixa de áudio baixar. Aceita default ou original (a faixa de áudio original do vídeo).

default

contexto: start_at

Carimbo de data/hora para o início do download parcial do vídeo (clipe) em hh:mm:ss formato. Saiba mais.

contexto: end_at

Carimbo de data/hora para o término do download parcial do vídeo (clipe) em hh:mm:ss formato. Deve ser posterior a start_at. Saiba mais.

– parâmetro obrigatório

Enviando um job único

Endpoint

Entrada

Forneça os parâmetros do job em um payload JSON, como mostrado no exemplo abaixo:

Job em lote

Você pode enviar até 5.000 IDs de vídeo em uma única solicitação em lote.

Endpoint

Entrada

A API responderá com um objeto JSON, contendo as informações do job para cada job criado. O status do job será pendente até que o download seja concluído.

Verificando o status do job

Se você forneceu uma URL de callback válida ao enviar seu job, nós o notificaremos quando ele for concluído enviando um JSON payload para a URL de callback especificada.

No entanto, se você enviou um job sem usar o serviço de callback, você pode verificar o status do job manualmente. Recupere a URL do href campo rel:self na seção da mensagem de resposta recebida após o envio do job. A URL para verificar o status do job será semelhante à seguinte: http://data.oxylabs.io/v1/queries/12345678900987654321. Consultar essa URL retornará as informações do job, incluindo seu status.

Endpoint

Download parcial (recorte)

Para baixar um segmento ou clipe específico em vez do vídeo completo, adicione 2 parâmetros adicionais ao seu context array:

  • start_at – timestamp inicial do clipe recortado em hh:mm:ss formato.

  • end_at – timestamp final do clipe recortado em hh:mm:ss formato.

Se ambos os parâmetros forem omitidos, a solicitação se comporta como um download completo padrão do vídeo.

Se start_at ou end_at falharem na validação, o HTTP 400 erro é retornado com um campo .

Condição
Mensagem de erro

start_at não está em hh:mm:ss formato

Valor inválido de start_at no contexto. Formato suportado: hh:mm:ss.

end_at não está em hh:mm:ss formato

Valor inválido de end_at no contexto. Formato suportado: hh:mm:ss.

end_at não é posterior a start_at

Valor inválido de end_at no contexto. Deve ser posterior a start_at.

Armazenamento em nuvem

Você pode fazer com que seus vídeos do YouTube sejam entregues em Google Cloud Storage, Amazon S3, Alibaba OSS, ou outro armazenamento em nuvem compatível com S3.

Os arquivos de conteúdo aparecerão no local de armazenamento em nuvem e receberão nomes de acordo com um dos seguintes esquemas de nomenclatura:

  • {video_id}_{job_id}.mp4 – para vídeo

  • {video_id}_{job_id}.m4a – para áudio

Parâmetros de armazenamento

Parâmetro
Descrição
Valores válidos

storage_type

Seu tipo de armazenamento em nuvem.

gcs (Google Cloud Storage);

s3 (AWS S3); s3_compatible (soluções de armazenamento compatíveis com S3).

storage_url

A URL do seu armazenamento em nuvem

Qualquer s3 ou gcs nome de bucket;

Qualquer compatível com S3 URL de armazenamento.

Configuração do Google Cloud Storage

Para que os resultados do seu job sejam enviados para o seu bucket do Google Cloud Storage, por favor configure permissões especiais para nosso serviço conforme mostrado na nossa documentação do Google Cloud Storage.

Configuração do Amazon S3

Para que os resultados do seu job sejam enviados para o seu bucket do Amazon S3, configure permissões de acesso para nosso serviço. Para isso, vá para https://s3.console.aws.amazon.com/S3ArmazenamentoNome do bucket ``(se você não tiver um, crie um novo)PermissõesPolítica do bucket. Você pode encontrar todas as etapas necessárias na nossa documentação em nuvem do Amazon S3.

Use a política de bucket abaixo (não se esqueça de alterar o nome do bucket em YOUR_BUCKET_NAME):

Esta política nos permite gravar no seu bucket, dar a você acesso aos arquivos enviados e saber a localização do bucket.

Configuração do Alibaba Cloud OSS

Para salvar os resultados no seu Alibaba Cloud Object Storage Service (OSS), você deve criar o ACCESS_KEY_ID e ACCESS_KEY_SECRET e usá-las para formar a URL de armazenamento. Siga as instruções descritas na nossa documentação do Alibaba Cloud OSS .

Configuração de armazenamento compatível com S3

Se você gostaria de ter seus resultados entregues em outro local de armazenamento compatível com S3 você precisará incluir a string de autenticação ACCESS_KEY:SECRET do seu bucket na storage_url valor no payload:

Códigos de erro

Código
Status
Descrição

11201

VIDEO_DELETED

O vídeo foi excluído.

11202

VIDEO_UNAVAILABLE

O vídeo não está disponível.

11203

VIDEO_PRIVATE

O vídeo foi definido como privado pelo uploader e somente ele e as pessoas explicitamente convidadas podem vê-lo.

11204

VIDEO_GEO_RESTRICTED

O vídeo tem restrição geográfica.

11205

VIDEO_LIVE

O vídeo está ao vivo agora.

11206

VIDEO_AGE_RESTRICTED

O vídeo tem restrição de idade.

11207

VIDEO_MEMBER_ONLY

O vídeo é apenas para membros do canal, e os espectadores precisam pagar a taxa de assinatura mensal.

11208

VIDEO_PREMIUM_ONLY

O vídeo requer a assinatura do YouTube Premium.

11209

VIDEO_LIVE_OR_TOO_LONG

O vídeo está ao vivo ou é longo demais para ser baixado.

11210

VIDEO_TOO_LONG

O vídeo é longo demais para ser baixado.

11211

VIDEO_SIGN_IN_REQUIRED

É necessário fazer login.

Atualizado

Isto foi útil?