# FlashData YouTube Download API

Download YouTube video of audio naar uw cloudopslag. Kies resolutie, formaat en clipduur, volg vervolgens de asynchrone taak door voltooiing.

Canonische referentie: https://flashdata.dev/nl/docs/sources/youtube_download
Beoordeeld: 2026-10-23

Eindpunt: POST https://data.flashdata.dev/v1/queries
Authenticatie: X-API-Key: YOUR_API_KEY
Modi: [Async](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/nl/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/nl/docs/reference/bulk-processing/reference.md)

Vereiste brontoestemming: youtube_download

Vervang YOUR_API_KEY door een API sleutel met deze bronmachtiging en beschikbare credits. Verzoeken uitvoeren op uw server of agent host.

[Authenticatie instellen](https://flashdata.dev/nl/docs/guides/headers-and-authentication/reference.md)

[Download één video en verifieer levering](https://flashdata.dev/nl/docs/guides/download-video-recipe/reference.md)

[YouTube-video-download-API — Python-voorbeelden](https://github.com/flashdatadev/youtube-video-download-api)

<a id="quickstart"></a>

## Een verzoek versturen

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_download",
    "video_id": "jNQXAC9IVRw",
    "params": {
        "download_type": "audio_video",
        "video_quality": "<=720",
        "output_format": "mp4",
        "storage": {
            "storage_type": "s3",
            "storage_url": "your-media-bucket",
            "access_key": "YOUR_ACCESS_KEY",
            "secret_key": "YOUR_SECRET_KEY",
            "region": "us-east-1",
        },
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "video_quality": "<=720",
    "output_format": "mp4",
    "storage": {
      "storage_type": "s3",
      "storage_url": "your-media-bucket",
      "access_key": "YOUR_ACCESS_KEY",
      "secret_key": "YOUR_SECRET_KEY",
      "region": "us-east-1"
    }
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parameters

<a id="parameters-group-0"></a>

### Aanvraaginhoud

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Instellen op youtube_download.  |
| <a id="parameter-video_id"></a> video_id | string | Ja | Niet ingesteld | De 11-karakter YouTube video ID, zoals FUfGcZ092b0. Accepteert letters, cijfers, onderstrepingen en koppeltekens. Min lengte: 11. Maximale lengte: 11. Patroon: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | Ja | — | Settings voor dit verzoek.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nee | Niet ingesteld | Async en alleen batch. Publieke HTTPS voltooiing URL op poort 443, tot 2,048 tekens. Geen gebruikersgegevens of URL-fragment. Gebruik null of een lege tekenreeks zonder melding. In een batch, zet dit op elke query, buiten params.  |

<a id="parameters-group-1"></a>

### Video & audio

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-download_type"></a> params.download_type | string | Nee | "audio_video" | audio_video fuseert video en audio; video selecteert alleen video; audio selecteert alleen audio. Toegestaan: "audio_video", "video", "audio". Min lengte: 1. Maximale lengte: 11. |
| <a id="parameter-params-video_quality"></a> params.video_quality | string | Nee | "<=720" | Selectie van videoresolutie. Toestemming voor audio-alleen-downloads. Toegestaan: "best", "worst", "<=144", "==144", ">=144", "<=360", "==360", ">=360", "<=480", "==480", ">=480", "<=720", "==720", ">=720", "<=1080", "==1080", ">=1080", "<=1440", "==1440", ">=1440", "<=2160", "==2160", ">=2160", "<=4320", "==4320", ">=4320". Min lengte: 1. Maximale lengte: 40. |
| <a id="parameter-params-fps"></a> params.fps | string | Nee | Niet ingesteld | frame-snelheidsbeperking: <=, <= of == gevolgd door een waarde van 1 tot 240. Toestemming voor audio-alleen-downloads. Min lengte: 1. Maximale lengte: 6. Patroon: ^(?:>=\|<=\|==)(?:[1-9]\d?\|1\d\d\|2[0-3]\d\|240)$ |
| <a id="parameter-params-audio_language"></a> params.audio_language | string | Nee | "default" | Audiospoorselectie. Geldt voor audio_video en audio. Toegestaan: "default", "original". Min lengte: 1. Maximale lengte: 8. |
| <a id="parameter-params-audio_quality"></a> params.audio_quality | string | Nee | "best" | Audio-only bitrate in kbps, of beter. Numerieke keuzes moeten als strings worden verzonden. Omhoog voor video downloads. Toegestaan: "best", "320", "256", "192", "128". Min lengte: 1. Maximale lengte: 10. |
| <a id="parameter-params-output_format"></a> params.output_format | string | Nee | mp4 (video) / m4a (audio) | Video: mp4, webm of mkv. Geluid: m4a, mp3 of opus. Toegestaan: "mp4", "webm", "mkv", "m4a", "mp3", "opus". Min lengte: 1. Maximale lengte: 10. |
| <a id="parameter-params-yt_dlp_format"></a> params.yt_dlp_format | string | Nee | Niet ingesteld | Geavanceerde format selector, van 1 tot 1,024 tekens na het trimmen van whitespace. Controle karakters worden geweigerd. Overrides video_quality, fps en audio_language, waarvan de waarden vervolgens worden genegeerd; uitvoerformaat en knippen zijn nog steeds van toepassing. Min lengte: 1. Maximale lengte: 1024. |
| <a id="parameter-params-upload_metadata"></a> params.upload_metadata | boolean | Nee | false | Upload een metadata JSON bestand naast het mediabestand in uw opslag.  |

<a id="parameters-group-2"></a>

### Knippen

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-start_at"></a> params.start_at | string | Nee | Niet ingesteld | Clip start in H:MM:SS of HH:MM:SS formaat, van 00:00:00 naar 12:00:00. Standaard voor 00:00:00 wanneer alleen end_at wordt geleverd. Min lengte: 1. Maximale lengte: 8. Patroon: ^\d{1,2}:[0-5]\d:[0-5]\d$ |
| <a id="parameter-params-end_at"></a> params.end_at | string | Nee | Niet ingesteld | Clip einde in H:MM:SS of HH:MM:SS formaat, tot 12:00:00. Moet later zijn dan start_at. Min lengte: 1. Maximale lengte: 8. Patroon: ^\d{1,2}:[0-5]\d:[0-5]\d$ |

<a id="parameters-group-3"></a>

### Bestemming opslag

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-storage"></a> params.storage | object | Ja | — | Bestemming voor voltooide mediabestanden. Alleen de vermelde opslagvelden worden geaccepteerd.  |
| <a id="parameter-params-storage-storage_type"></a> params.storage.storage_type | string | Ja | — | Storage provider: s3, s3_compatible, oss, gcs, azuurblauw, cos, baas of tos.  |
| <a id="parameter-params-storage-storage_url"></a> params.storage.storage_url | string | Ja | — | Niet-lege emmer of containernaam, tot 1,024 tekens. Omsingel witruimte wordt verwijderd. Gebruik voor s3 een geldige AWS-emmernaam zonder URL of mappenpad; mappen behoren in object_prefix.  |
| <a id="parameter-params-storage-object_prefix"></a> params.storage.object_prefix | string | Nee | "YYYYMMDD" | Object-key prefix, 1 naar 512 tekens. Elk door schuine streep gescheiden segment accepteert ASCII-letters, cijfers, stippen, onderstrepingen en koppeltekens; lege segmenten, . en .. worden afgewezen. Geen voorsprong. Rondom witruimte en een achterwaartse slash worden verwijderd. JJJJMMDD gebruikt de UTC-uploaddatum, inclusief in archive/YYYYMMDD.  |
| <a id="parameter-params-storage-access_key"></a> params.storage.access_key | string | Nee | — | Toegangssleutel voor S3, S3-compatibel, OSS, COS, BOS of TOS; gekoppeld met secret_key.  |
| <a id="parameter-params-storage-secret_key"></a> params.storage.secret_key | string | Nee | — | Geheime sleutel voor S3, S3-compatibel, OSS, COS, BOS of TOS.  |
| <a id="parameter-params-storage-endpoint_url"></a> params.storage.endpoint_url | string | Nee | — | Public HTTPS eindpunt voor S3-compatibele opslag of OSS. COS, BOS en TOS zijn afkomstig uit de regio.  |
| <a id="parameter-params-storage-region"></a> params.storage.region | string | Nee | — | Vereist voor COS, BOS en TOS; ook levering voor S3 en S3-compatibele downloads. De namen van de COS-emmers zijn inclusief de APPID.  |
| <a id="parameter-params-storage-service_account"></a> params.storage.service_account | object | Nee | — | GCS-serviceaccount: project_id, client_email en PEM private_key.  |
| <a id="parameter-params-storage-account_name"></a> params.storage.account_name | string | Nee | — | Azure opslagaccountnaam. Gebruik de containernaam in storage_url.  |
| <a id="parameter-params-storage-sas_token"></a> params.storage.sas_token | string | Nee | — | Azure-container SAS met schrijf-enabled met vervaldatum en handtekening.  |

<a id="response"></a>

## Lees het resultaat

Nadat de taak is voltooid, slaat u de JSON op van de resultatenlink als response.json. Sla dit op als read-response.py en voer python read-response.py uit. Het leest bestandsdetails zonder media te downloaden of een ander verzoek te doen.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {name: result.get(name) for name in (
    "file_url", "file_size", "md5", "duration", "output_format"
)}
# Use your storage credentials to access the media at file_url.
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Indiening van het monster

Opgenomen voorbeeld; velden en tellingen zijn afhankelijk van de bron en de gevraagde invoer.
```json
{
  "id": "job_d265c693-950e-40bf-a13e-a432044d99ba",
  "source": "youtube_download",
  "status": "pending",
  "usage": {
    "credits": 0
  },
  "created_at": "2026-09-16T07:51:13.139Z",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba/results",
      "method": "GET"
    }
  ]
}
```

## Responsvelden

| Veld | Type | Omschrijving |
| --- | --- | --- |
| id | string | Download taak ID. |
| source | string | youtube_download. |
| status | string | in afwachting van de aanvaarding van de opdracht. |
| created_at | string | Job creation time in ISO 8601 formaat. |
| usage.credits | number | 0 bij inzending. Downloads worden berekend door geleverde data volume na voltooiing. |
| links | array | Volg de selflink voor de functiestatus en de resultatenlink voor voltooide output. |
| links[].rel | string | zelf of resultaten. |
| links[].href | string | URL om te vragen met dezelfde API sleutel. |
| links[].method | string | GET. |

- Downloads draaien als achtergrondtaken. Het inzendingsantwoord bevat een taak ID; het bevat geen mediabestand. Volg de taakstatus tot voltooiing, dan het resultaat van het beschrijven van de bestanden die in uw opslagruimte. Downloads verzenden naar /v1/queries of /v1/queries/batch; /v1/queries/realtime accepteert geen downloadverzoeken.

## Antwoordformaten

Antwoorden gebruiken JSON standaard. Kies een ander formaat met deze optionele headers.

- Accept: application/json (standaard) of text/plain. Platte tekst geeft dezelfde velden weer in een leesbare, ingespringde lay-out.
- X-Respond-With: markdown. Laat uitgevallen voor originele velden. Markdown werkt met beide responsformaten.

Markdown formatteert de download manifest; mediabestanden houden hun oorspronkelijke formaat. Alleen ontvangstbewijzen en functiestatus ondersteuning Accept.

De velden hieronder beschrijven de standaard JSON response.

[Voorbeelden van verzoeken en antwoorden](https://flashdata.dev/nl/docs/guides/response-formats/reference.md#completed-results)

<a id="storage"></a>

## Bestemming opslag

Voor single-job- en Batch-downloads is params.storage nodig; Bulk downloads gebruiken options.storage. storage_url is de emmer of containernaam. Leveren referenties met schrijf toegang en houd ze op uw server.

### s3

Levering access_key en secret_key met schrijftoegang. Stel de regio in voor de AWS-regio van uw emmer.

```json
{
  "storage_type": "s3",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1"
}
```

### s3_compatible

Supply access_key, secret_key en een publieke HTTPS endpoint_url. Stel de regio in zoals vereist door uw provider; Cloudflare R2 maakt gebruik van auto.

```json
{
  "storage_type": "s3_compatible",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com",
  "region": "auto"
}
```

### azure

Supply account_name en sas_token, een container SAS met schrijfmachtiging (sp bevat w), resource sr=c, expiration se, versie sv en handtekening sig. storage_url is de containernaam. Verzend endpoint_url, access_key of secret_key niet.

```json
{
  "storage_type": "azure",
  "storage_url": "your-media-container",
  "account_name": "yourstorageaccount",
  "sas_token": "sv=2023-11-03&sr=c&sp=w&se=2099-01-01T00%3A00%3A00Z&sig=YOUR_SAS_SIGNATURE"
}
```

### bos

Levering access_key, secret_key en regio: bj, su of hkg. Het eindpunt is afgeleid van regio wanneer weggelaten. Gebruik een emmernaam zonder puntjes.

```json
{
  "storage_type": "bos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "bj"
}
```

### cos

Supply access_key, secret_key en een ap-* regio, zoals ap-hongkong. storage_url moet het APPID achtervoegsel bevatten. Stuur endpoint_url niet; het is afgeleid van regio.

```json
{
  "storage_type": "cos",
  "storage_url": "your-media-bucket-1234567890",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "ap-hongkong"
}
```

### gcs

Lever service_account met project_id, client_email (een .gserviceaccount.com-adres) en de PEM private_key van uw serviceaccount. De rekening moet schrijftoegang tot de emmer hebben. Verzend access_key, secret_key, regio of endpoint_url niet.

```json
{
  "storage_type": "gcs",
  "storage_url": "your-media-bucket",
  "service_account": {
    "project_id": "your-project-id",
    "client_email": "uploader@your-project-id.iam.gserviceaccount.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n"
  }
}
```

### oss

Supply access_key, secret_key en de publieke HTTPS endpoint_url van de emmerregio.

```json
{
  "storage_type": "oss",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "endpoint_url": "https://oss-cn-hongkong.aliyuncs.com"
}
```

### tos

Levering access_key, secret_key en regio met een cn-, ap-, eu- of us-prefix. Het eindpunt is afgeleid van regio wanneer weggelaten. Gebruik een emmernaam zonder puntjes.

```json
{
  "storage_type": "tos",
  "storage_url": "your-media-bucket",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "cn-beijing"
}
```

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API-basisprincipes

De aanvraagbouwer en voorbeelden hierboven gebruiken de parameters van deze bron. Gebruik hieronder de voorbeelden Python en cURL voor gedeelde inzending, status en resultaatstappen. Een Batch body is een JSON object met queries; elk item geeft zijn eigen job ID terug.

- [Async verzoek en ontvangst](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Taakstatus controleren](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Gereedgemaakte resultaten ophalen](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON verzoeken](https://flashdata.dev/nl/docs/reference/batch-and-bulk/reference.md#batch)
- [API voor Bulk-verwerking](https://flashdata.dev/nl/docs/reference/bulk-processing/reference.md)
- [Bouw een Bulk workflow voor deze bron](https://flashdata.dev/nl/docs/reference/bulk-processing/reference.md?source=youtube_download#playground)
- [Klant OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Aanmeldingen tot voltooiing

- [Ontvang en verifieer complete webhooks](https://flashdata.dev/nl/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Problemen oplossen

- [Fouten en statuscodes](https://flashdata.dev/nl/docs/errors/reference.md#status-codes)
- [Wanneer opnieuw proberen](https://flashdata.dev/nl/docs/errors/reference.md#retries)

<a id="delivery"></a>

## Bestandsaflevering

Download ondersteunt niet realtime.

Media wordt geüpload naar uw geconfigureerde opslag; resultaat JSON beschrijft deze bestanden. Private media gebruikt uw opslagauthenticatie. JSON resultaten verlopen 24 uren na voltooiing; media volgen uw opslagretentiebeleid.

## Gerelateerde API's

- [YouTube Video Metadata API](https://flashdata.dev/nl/docs/sources/youtube_metadata/reference.md)
- [YouTube Transcript API](https://flashdata.dev/nl/docs/sources/youtube_transcript/reference.md)
