> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/api-targets/pt-br/video-e-midias-sociais/youtube/youtube-downloader.md). # Downloader A `youtube_download` 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 [**Push-Pull integration**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md) e o [**Cloud Storage**](/products/pt-br/web-scraper-api/features/result-processing-and-storage/cloud-storage.md) recurso. ## Como o YouTube Downloader funciona 1. Envie via API: * Um ou mais IDs de vídeo do YouTube; * Detalhes do armazenamento em nuvem. 2. Receba a resposta da API com a confirmação de que sua solicitação para baixar um vídeo foi aceita com sucesso. 3. Receba os vídeos no local de armazenamento em nuvem especificado assim que forem processados pelo nosso sistema. {% hint style="success" %} **Observação**: * O downloader usa a resolução de vídeo 720p por padrão. Se 720p não estiver disponível, o downloader escolherá a melhor qualidade disponível abaixo de 720p. Você pode substituir esse comportamento usando o `context: video_quality`parâmetro. * Você pode baixar vídeos de até 12 horas de duração. * O tempo de download é limitado a 1 hora. {% endhint %} ## Valores dos parâmetros de entrada
ParâmetroDescriçãoValor padrão
sourceDefine o scraper. Use youtube_download.–
queryID do vídeo do YouTube.–
storage_typeTipo de armazenamento do serviço em nuvem (gcs, s3 ou s3_compatible)–
storage_urlO nome do bucket (para AWS S3) ou a URL (para outro armazenamento compatível com S3) do local de armazenamento em nuvem para o qual você gostaria que o resultado fosse enviado.–
callback_urlA URL do seu endpoint de callback. Mais informações–
context:
download_type		Especifica se deve baixar áudio, vídeo, ou ambos - audio_video.audio_video
context:
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:
start_at		Carimbo de data/hora para o início do download parcial do vídeo (clipe) em hh:mm:ss formato. Saiba mais.–
context:
end_at		Carimbo de data/hora para o fim 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 único job #### Endpoint ``` POST https://data.oxylabs.io/v1/queries ``` #### Entrada Forneça os parâmetros do job em um payload JSON, como mostrado no exemplo abaixo: {% tabs %} {% tab title="cURL" %} ```sh curl --user "user:pass1" \\ 'https://data.oxylabs.io/v1/queries' \\ -H "Content-Type: application/json" \\ -d '{ "source": "youtube_download", "query": "9cQBNYsCqQs", "storage_type": "s3", "storage_url": "s3://your-s3-bucket/your-folder/" }' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint payload = { "source": "youtube_download", "query": "9cQBNYsCqQs", "context": [ { "key": "download_type", "value": "video" }, { "key": "video_quality", "value": "1080" } ], "storage_type": "s3", "storage_url": "s3://your-s3-bucket/your-folder/" } response = requests.request( 'POST', 'https://data.oxylabs.io/v1/queries', auth=('user', 'pass1'), json=payload, ) pprint(response.json()) ``` {% endtab %} {% tab title="PHP" %} ```php 'youtube_download', 'query' => '9cQBNYsCqQs', "context" => [ [ "key" => "download_type", "value" => "video", ], [ "key" => "video_quality", "value" => "1080", ] ], 'storage_type' => 's3', 'storage_url' => 's3://your-s3-bucket/your-folder/' ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://data.oxylabs.io/v1/queries"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params)); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERPWD, "YOUR_USERNAME" . ":" . "YOUR_PASSWORD"); $headers = array(); $headers[] = "Content-Type: application/json"; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); echo $result; if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close ($ch); ?> ``` {% endtab %} {% tab title="C#" %} ```csharp using System; using System.Collections.Generic; using System.Net.Http; using System.Net.Http.Json; using System.Threading.Tasks; namespace OxyApi { class Program { static async Task Main() { const string Username = "YOUR_USERNAME"; const string Password = "YOUR_PASSWORD"; var payload = new Dictionary() { { "source", "youtube_download" }, { "query", "9cQBNYsCqQs" }, { "context", new[] { new { key = "download_type", value = "video" }, new { key = "video_quality", value = "1080" } }}, { "storage_type", "s3" }, { "storage_url", "your-s3-bucket/your-folder/" } }; var client = new HttpClient(); var requestMessage = new HttpRequestMessage(HttpMethod.Post, "https://data.oxylabs.io/v1/queries/batch"); requestMessage.Content = JsonContent.Create(payload); var authenticationString = $"{Username}:{Password}"; var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString)); requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString); var response = await client.SendAsync(requestMessage); var contents = await response.Content.ReadAsStringAsync(); Console.WriteLine(contents); } } } ``` {% endtab %} {% tab title="Golang" %} ```go package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { const Username = "YOUR_USERNAME" const Password = "YOUR_PASSWORD" // Define the context structure type ContextItem struct { Key string `json:"key"` Value string `json:"value"` } // Create payload with the same structure as the C# example payload := map[string]interface{}{ "source": "youtube_download", "query": []string{"9cQBNYsCqQs", "KGOsWPF4Wfs"}, "context": []ContextItem{ {Key: "download_type", Value: "video"}, {Key: "video_quality", Value: "1080"}, }, "storage_type": "s3", "storage_url": "your-s3-bucket/your-folder/", } jsonValue, _ := json.Marshal(payload) client := &http.Client{} request, _ := http.NewRequest("POST", "https://data.oxylabs.io/v1/queries/batch", bytes.NewBuffer(jsonValue), ) request.Header.Add("Content-type", "application/json") request.SetBasicAuth(Username, Password) response, _ := client.Do(request) responseText, _ := ioutil.ReadAll(response.Body) fmt.Println(string(responseText)) } ``` {% endtab %} {% tab title="Java" %} ```java package org.example; import okhttp3.*; import org.json.JSONArray; import org.json.JSONObject; public class Main implements Runnable { private static final String AUTHORIZATION_HEADER = "Authorization"; public static final String USERNAME = "YOUR_USERNAME"; public static final String PASSWORD = "YOUR_PASSWORD"; public void run() { JSONObject jsonObject = new JSONObject(); jsonObject.put("source", "youtube_download"); jsonObject.put("query", "9cQBNYsCqQs"); // Add context structure JSONArray contextArray = new JSONArray(); JSONObject downloadTypeContext = new JSONObject(); downloadTypeContext.put("key", "download_type"); downloadTypeContext.put("value", "video"); contextArray.put(downloadTypeContext); JSONObject videoQualityContext = new JSONObject(); videoQualityContext.put("key", "video_quality"); videoQualityContext.put("value", "1080"); contextArray.put(videoQualityContext); jsonObject.put("context", contextArray); jsonObject.put("storage_type", "s3"); jsonObject.put("storage_url", "your-s3-bucket/your-folder/"); Authenticator authenticator = (route, response) -> { String credential = Credentials.basic(USERNAME, PASSWORD); return response .request() .newBuilder() .header(AUTHORIZATION_HEADER, credential) .build(); }; var client = new OkHttpClient.Builder() .authenticator(authenticator) .build(); var mediaType = MediaType.parse("application/json; charset=utf-8"); var body = RequestBody.create(jsonObject.toString(), mediaType); var request = new Request.Builder() .url("https://data.oxylabs.io/v1/queries/batch") .post(body) .build(); try (var response = client.newCall(request).execute()) { assert response.body() != null; System.out.println(response.body().string()); } catch (Exception exception) { System.out.println("Error: " + exception.getMessage()); } System.exit(0); } public static void main(String[] args) { new Thread(new Main()).start(); } } ``` {% endtab %} {% tab title="Node.js" %} ```sh import fetch from 'node-fetch'; const username = 'YOUR_USERNAME'; const password = 'YOUR_PASSWORD'; const body = { source: 'youtube_download', query: '9cQBNYsCqQs', context: [ { key: "download_type", value: "video" }, { key: "video_quality", value: "1080"}, ], storage_type: 's3', storage_url: 's3://your-s3-bucket/your-folder/' }; const response = await fetch('https://data.oxylabs.io/v1/queries', { method: 'post', body: JSON.stringify(body), headers: { 'Content-Type': 'application/json', 'Authorization': 'Basic ' + Buffer.from(`${username}:${password}`).toString('base64'), } }); console.log(await response.json()); ``` {% endtab %} {% endtabs %} ## Job em lote Você pode enviar até 5.000 IDs de vídeo em uma única solicitação em lote. #### Endpoint ``` POST https://data.oxylabs.io/v1/queries/batch ``` {% hint style="warning" %} **IMPORTANTE:** Com `/batch` endpoint, você só pode enviar listas de `query`valores de parâmetros. Todos os outros parâmetros devem ter valores singulares. {% endhint %} #### Entrada {% tabs %} {% tab title="cURL" %} ```sh curl --user "user:pass1" \\ 'https://data.oxylabs.io/v1/queries/batch' \\ -H 'Content-Type: application/json' \\ -d '{ "source": "youtube_download", "query": ["9cQBNYsCqQs", "KGOsWPF4Wfs"], "context": [ { "key": "download_type", "value": "video" }, { "key": "video_quality", "value": "1080" } ], "storage_type": "s3", "storage_url": "your-s3-bucket/your-folder/" }' ``` {% endtab %} {% tab title="Python" %} ```python import requests import json from pprint import pprint payload = { "source": "youtube_download", "query": ["9cQBNYsCqQs", "KGOsWPF4Wfs"], "context": [ { "key": "download_type", "value": "video" }, { "key": "video_quality", "value": "1080" } ], "storage_type": "s3", "storage_url": "your-s3-bucket/your-folder/" } response = requests.request( 'POST', 'https://data.oxylabs.io/v1/queries/batch', auth=('user', 'pass1'), json=payload, ) # Imprima a resposta formatada. pprint(response.json()) ``` {% endtab %} {% tab title="PHP" %} ```php "youtube_download", "query" => array("9cQBNYsCqQs", "KGOsWPF4Wfs"), "context" => [ [ "key" => "download_type", "value" => "video", ], [ "key" => "video_quality", "value" => "1080", ] ], "storage_type" => "s3", "storage_url" => "your-s3-bucket/your-folder/" ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://data.oxylabs.io/v1/queries/batch"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload)); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERPWD, "user" . ":" . "pass1"); $headers = array(); $headers[] = "Content-Type: application/json"; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); echo $result; if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close ($ch); ?> ``` {% endtab %} {% tab title="C#" %} ```csharp using System; using System.Collections.Generic; using System.Net.Http; using System.Net.Http.Json; using System.Threading.Tasks; namespace OxyApi { class Program { static async Task Main() { const string Username = "YOUR_USERNAME"; const string Password = "YOUR_PASSWORD"; var payload = new Dictionary() { { "source", "youtube_download" }, { "query", new[] { "9cQBNYsCqQs", "KGOsWPF4Wfs" } }, { "context", new[] { new { key = "download_type", value = "video" }, new { key = "video_quality", value = "1080" } }}, { "storage_type", "s3" }, { "storage_url", "your-s3-bucket/your-folder/" } }; var client = new HttpClient(); var requestMessage = new HttpRequestMessage(HttpMethod.Post, "https://data.oxylabs.io/v1/queries/batch"); requestMessage.Content = JsonContent.Create(payload); var authenticationString = $"{Username}:{Password}"; var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString)); requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString); var response = await client.SendAsync(requestMessage); var contents = await response.Content.ReadAsStringAsync(); Console.WriteLine(contents); } } } ``` {% endtab %} {% tab title="Golang" %} ```go package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { const Username = "YOUR_USERNAME" const Password = "YOUR_PASSWORD" // Define the context structure type ContextItem struct { Key string `json:"key"` Value string `json:"value"` } // Create payload with the same structure as the C# example payload := map[string]interface{}{ "source": "youtube_download", "query": "9cQBNYsCqQs", "context": []ContextItem{ {Key: "download_type", Value: "video"}, {Key: "video_quality", Value: "1080"}, }, "storage_type": "s3", "storage_url": "your-s3-bucket/your-folder/", } jsonValue, _ := json.Marshal(payload) client := &http.Client{} request, _ := http.NewRequest("POST", "https://data.oxylabs.io/v1/queries/batch", bytes.NewBuffer(jsonValue), ) request.Header.Add("Content-type", "application/json") request.SetBasicAuth(Username, Password) response, _ := client.Do(request) responseText, _ := ioutil.ReadAll(response.Body) fmt.Println(string(responseText)) } ``` {% endtab %} {% tab title="Java" %} ```java package org.example; import okhttp3.*; import org.json.JSONArray; import org.json.JSONObject; public class Main implements Runnable { private static final String AUTHORIZATION_HEADER = "Authorization"; public static final String USERNAME = "YOUR_USERNAME"; public static final String PASSWORD = "YOUR_PASSWORD"; public void run() { JSONObject jsonObject = new JSONObject(); jsonObject.put("source", "youtube_download"); // Change query to array format like in C# example JSONArray queryArray = new JSONArray(); queryArray.put("9cQBNYsCqQs"); queryArray.put("KGOsWPF4Wfs"); jsonObject.put("query", queryArray); // Add context structure JSONArray contextArray = new JSONArray(); JSONObject downloadTypeContext = new JSONObject(); downloadTypeContext.put("key", "download_type"); downloadTypeContext.put("value", "video"); contextArray.put(downloadTypeContext); JSONObject videoQualityContext = new JSONObject(); videoQualityContext.put("key", "video_quality"); videoQualityContext.put("value", "1080"); contextArray.put(videoQualityContext); jsonObject.put("context", contextArray); jsonObject.put("storage_type", "s3"); jsonObject.put("storage_url", "your-s3-bucket/your-folder/"); Authenticator authenticator = (route, response) -> { String credential = Credentials.basic(USERNAME, PASSWORD); return response .request() .newBuilder() .header(AUTHORIZATION_HEADER, credential) .build(); }; var client = new OkHttpClient.Builder() .authenticator(authenticator) .build(); var mediaType = MediaType.parse("application/json; charset=utf-8"); var body = RequestBody.create(jsonObject.toString(), mediaType); var request = new Request.Builder() .url("https://data.oxylabs.io/v1/queries/batch") .post(body) .build(); try (var response = client.newCall(request).execute()) { assert response.body() != null; System.out.println(response.body().string()); } catch (Exception exception) { System.out.println("Error: " + exception.getMessage()); } System.exit(0); } public static void main(String[] args) { new Thread(new Main()).start(); } } ``` {% endtab %} {% tab title="Node.js" %} ```javascript import fetch from 'node-fetch'; const username = 'YOUR_USERNAME'; const password = 'YOUR_PASSWORD'; const payload = { source: 'youtube_download', query: ['9cQBNYsCqQs', 'KGOsWPF4Wfs'], context: [ { key: "download_type", value: "video" }, { key: "video_quality", value: "1080"}, ] storage_type: 's3', storage_url: 'your-s3-bucket/your-folder/' }; const response = await fetch('https://data.oxylabs.io/v1/queries/batch', { method: 'post', body: JSON.stringify(payload), headers: { 'Content-Type': 'application/json', 'Authorization': 'Basic ' + Buffer.from(`${username}:${password}`).toString('base64'), } }); console.log(await response.json()); ``` {% endtab %} {% endtabs %} 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**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md#callback) 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 [**serviço de callback**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md#callback), você pode verificar o status do job manualmente. Recupere a URL do `href` campo na `rel:self` 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 ``` GET https://data.oxylabs.io/v1/queries/{id} ``` ## Download parcial (recorte) Para baixar um segmento ou clipe específico em vez do vídeo completo, adicione 2 parâmetros adicionais ao seu `contexto` vetor: * `start_at` – carimbo de data/hora de início do clipe recortado em `hh:mm:ss` formato. * `end_at` – carimbo de data/hora de fim do clipe recortado em `hh:mm:ss` formato. {% hint style="warning" %} `end_at` o valor do carimbo de data/hora deve ser posterior a `start_at`. Apenas `hh:mm:ss` o formato é suportado. {% endhint %} ```json { "source": "youtube_download", "query": "0xFXmJgVgzc", "context": [ { "key": "start_at", "value": "00:01:30" }, { "key": "end_at", "value": "00:05:45" } ], "storage_type": "s3", "storage_url": "s3://your-s3-bucket/your-folder/" } ``` {% hint style="info" %} Se ambos os parâmetros forem omitidos, a requisição se comporta como um download padrão do vídeo completo. {% endhint %} Se `start_at` ou `end_at` falharem na validação, o HTTP `400` erro é retornado com um `message` campo.
CondiçãoMensagem de erro
start_at não está em hh:mm:ss formatoValor de start_at inválido no contexto. Formato suportado: hh:mm:ss.
end_at não está em hh:mm:ss formatoValor de end_at inválido no contexto. Formato suportado: hh:mm:ss.
end_at não é posterior a start_atValor de end_at inválido no contexto. Deve ser posterior a start_at.
## Armazenamento em nuvem Você pode ter seus vídeos do YouTube enviados para [**Google Cloud Storage**](#google-cloud-storage-setup), [**Amazon S3**](#amazon-s3-setup), [**Alibaba Cloud OSS**](#alibaba-cloud-oss-setup), ou [**outro armazenamento em nuvem compatível com S3**](#s3-compatible-storage-setup). Os arquivos de conteúdo aparecerão no local de armazenamento em nuvem e serão nomeados de acordo com um dos seguintes esquemas de nomeação: * `{video_id}_{job_id}.mp4` – para vídeo * `{video_id}_{job_id}.m4a` – para áudio ### Parâmetros de armazenamento
ParâmetroDescriçãoValores válidos
storage_typeSeu tipo de armazenamento em nuvem.

gcs (Google Cloud Storage);

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

storage_urlSua URL de armazenamento em nuvem

Qualquer s3 ou gcs nome do 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 o nosso serviço** conforme mostrado em nossa [documentação do Google Cloud Storage](/products/pt-br/web-scraper-api/features/result-processing-and-storage/cloud-storage.md#google-cloud-storage). ```json { "source": "youtube_download", "query": "9cQBNYsCqQs", "storage_type": "gcs", "storage_url": "bucket_name/path" } ``` ### 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 o nosso serviço. Para fazer isso, acesse [**https://s3.console.aws.amazon.com/**](https://s3.console.aws.amazon.com/) → **`S3`** → **`Armazenamento`** → **`Nome do bucket`**` ``(se você não tiver um, crie um novo)` → **`Permissões`** → **`Política do bucket`**. Você pode encontrar todas as etapas necessárias em nossa [documentação em nuvem do Amazon S3](/products/pt-br/web-scraper-api/features/result-processing-and-storage/cloud-storage.md#amazon-s3). Use a política do bucket abaixo (não se esqueça de alterar o nome do bucket em `YOUR_BUCKET_NAME`): ```json { "Version": "2012-10-17", "Id": "Policy1577442634787", "Statement": [ { "Sid": "Stmt1577442633719", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::324311890426:user/oxylabs.s3.uploader" }, "Action": "s3:GetBucketLocation", "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME" }, { "Sid": "Stmt1577442633719", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::324311890426:user/oxylabs.s3.uploader" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/*" } ] } ``` Esta política nos permite gravar no seu bucket, conceder 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 em nossa [documentação do Alibaba Cloud OSS ](/products/pt-br/web-scraper-api/features/result-processing-and-storage/cloud-storage.md#alibaba-cloud-object-storage-service-oss). ```json { "source": "youtube_download", "query": "9cQBNYsCqQs", "storage_type": "s3_compatible", "storage_url": "https://ACCESS_KEY_ID:ACCESS_KEY_SECRET@BUCKET_NAME.oss-REGION.aliyuncs.com/FOLDER_NAME" } ``` ### Configuração de armazenamento compatível com S3 Se você quiser que seus resultados sejam entregues em [outro armazenamento compatível com S3](/products/pt-br/web-scraper-api/features/result-processing-and-storage/cloud-storage.md#other-s3-compatible-storage) localização, você terá que incluir o `ACCESS_KEY:SECRET` string de autenticação no `storage_url` valor no payload: ```json { "source": "youtube_download", "query": "9cQBNYsCqQs", "storage_type": "s3_compatible", "storage_url": "https://ACCESS_KEY:SECRET@s3.oxylabs.io/my-videos" } ``` ## Códigos de erro
CódigoStatusDescrição
11201VIDEO_DELETEDO vídeo foi excluído.
11202VIDEO_UNAVAILABLEO vídeo não está disponível.
11203VIDEO_PRIVATEO vídeo foi definido como privado pelo uploader e somente ele e as pessoas explicitamente convidadas podem vê-lo.
11204VIDEO_GEO_RESTRICTEDO vídeo tem restrição geográfica.
11205VIDEO_LIVEO vídeo está ao vivo agora.
11206VIDEO_AGE_RESTRICTEDO vídeo possui restrição de idade.
11207VIDEO_MEMBER_ONLYO vídeo é exclusivo para membros do canal, e os espectadores precisam pagar a taxa mensal de assinatura.
11208VIDEO_PREMIUM_ONLYO vídeo requer a assinatura do YouTube Premium.
11209VIDEO_LIVE_OR_TOO_LONGO vídeo está ao vivo ou é longo demais para baixar.
11210VIDEO_TOO_LONGO vídeo é longo demais para baixar.
11211VIDEO_SIGN_IN_REQUIREDÉ necessário fazer login.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/api-targets/pt-br/video-e-midias-sociais/youtube/youtube-downloader.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.