Documentatie bekijken
API-referentie
YouTube Download API
Download YouTube video of audio naar uw cloudopslag. Kies resolutie, formaat en clipduur, volg vervolgens de asynchrone taak door voltooiing.
YouTube-video-download-API — Python-voorbeelden
Stel een aanvraag samen
De ID van 11 tekens uit de video-URL, niet de volledige URL.
Geavanceerde media-opties
Een formatkiezer overschrijft kwaliteit, framesnelheid en audio-taalkeuze. Uitvoerformaat en clipgrenzen zijn nog steeds van toepassing. Clip end moet volgen op start; beide gebonden kan worden weggelaten.
Bestemming opslag
Blanco gebruikt de UTC-uploaddatum (JJJJMMDD).
Voeg uw opslaggegevens op uw server toe voordat u de code gebruikt. Ze hebben toestemming nodig om bestanden te uploaden.
Vereisten inzake de identiteit van de aanbieder en de opslagAanvulling webhook
Webhook payload, verificatie en herhalingenMarkdown geldt voor voltooide resultaten. Ontvangst en functiestatus houden hun oorspronkelijke velden.
https://data.flashdata.dev/v1/queriesParameters
Verzenden source en video_id op het bovenste niveau. Bronopties horen in params. Optionele velden kunnen worden weggelaten.
Aanvraaginhoud
sourcestring / Vereist- Instellen op youtube_download.
video_idstring / Vereist- De 11-karakter YouTube video ID, zoals FUfGcZ092b0. Accepteert letters, cijfers, onderstrepingen en koppeltekens.Precies 11 tekensStandaard:
Niet ingesteldGeaccepteerd formaat
^[A-Za-z0-9_-]{11}$ paramsobject / Vereist- Settings voor dit verzoek.
callback_urlstring · nullable / Optioneel- 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.Standaard:
Niet ingesteld
Video & audio
params.download_typestring / Optioneel- audio_video fuseert video en audio; video selecteert alleen video; audio selecteert alleen audio.1 tot 11 tekensWaarden:
audio_video / video / audioStandaard:"audio_video" params.video_qualitystring / Optioneel- Selectie van videoresolutie. Toestemming voor audio-alleen-downloads.1 tot 40 tekensWaarden:
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 / >=4320Standaard:"<=720" params.fpsstring / Optioneel- frame-snelheidsbeperking: <=, <= of == gevolgd door een waarde van 1 tot 240. Toestemming voor audio-alleen-downloads.1 tot 6 tekensStandaard:
Niet ingesteldGeaccepteerd formaat
^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$ params.audio_languagestring / Optioneel- Audiospoorselectie. Geldt voor audio_video en audio.1 tot 8 tekensWaarden:
default / originalStandaard:"default" params.audio_qualitystring / Optioneel- Audio-only bitrate in kbps, of beter. Numerieke keuzes moeten als strings worden verzonden. Omhoog voor video downloads.1 tot 10 tekensWaarden:
best / 320 / 256 / 192 / 128Standaard:"best" params.output_formatstring / Optioneel- Video: mp4, webm of mkv. Geluid: m4a, mp3 of opus.1 tot 10 tekensWaarden:
mp4 / webm / mkv / m4a / mp3 / opusStandaard:mp4 (video) / m4a (audio) params.yt_dlp_formatstring / Optioneel- 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.1 tot 1.024 tekensStandaard:
Niet ingesteld params.upload_metadataboolean / Optioneel- Upload een metadata JSON bestand naast het mediabestand in uw opslag.
trueoffalseStandaard:false
Knippen
params.start_atstring / Optioneel- 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.1 tot 8 tekensStandaard:
Niet ingesteldGeaccepteerd formaat
^\d{1,2}:[0-5]\d:[0-5]\d$ params.end_atstring / Optioneel- Clip einde in H:MM:SS of HH:MM:SS formaat, tot 12:00:00. Moet later zijn dan start_at.1 tot 8 tekensStandaard:
Niet ingesteldGeaccepteerd formaat
^\d{1,2}:[0-5]\d:[0-5]\d$
Bestemming opslag
params.storageobject / Vereist- Bestemming voor voltooide mediabestanden. Alleen de vermelde opslagvelden worden geaccepteerd.
params.storage.storage_typestring / Vereist- Storage provider: s3, s3_compatible, oss, gcs, azuurblauw, cos, baas of tos.
params.storage.storage_urlstring / Vereist- 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.
params.storage.object_prefixstring / Optioneel- 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.Standaard:
"YYYYMMDD" params.storage.access_keystring / Optioneel- Toegangssleutel voor S3, S3-compatibel, OSS, COS, BOS of TOS; gekoppeld met secret_key.
params.storage.secret_keystring / Optioneel- Geheime sleutel voor S3, S3-compatibel, OSS, COS, BOS of TOS.
params.storage.endpoint_urlstring / Optioneel- Public HTTPS eindpunt voor S3-compatibele opslag of OSS. COS, BOS en TOS zijn afkomstig uit de regio.
params.storage.regionstring / Optioneel- Vereist voor COS, BOS en TOS; ook levering voor S3 en S3-compatibele downloads. De namen van de COS-emmers zijn inclusief de APPID.
params.storage.service_accountobject / Optioneel- GCS-serviceaccount: project_id, client_email en PEM private_key.
params.storage.account_namestring / Optioneel- Azure opslagaccountnaam. Gebruik de containernaam in storage_url.
params.storage.sas_tokenstring / Optioneel- Azure-container SAS met schrijf-enabled met vervaldatum en handtekening.
Antwoord
De verzoek bouwer dient downloads met Async of Batch en vereist params.storage. HTTP 200 met status: pending bevestigt aanvaarding, niet levering. Batch geeft één vacaturebon per video ID terug.
Indiening usage.credits is 0. Downloads worden gefactureerd door geleverd media volume na succesvolle levering; optionele metadata bestanden niet toevoegen aan downloadkosten.
Poll job.status tot completed, dan het resultaat JSON ophalen. Lees de media details op results[0], inclusief de geüploade objecten file_url, bestandsgrootte en controlesom.
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.
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))De status kan mediadetails bevatten in job.result. Standaard JSON workflows gebruiken ze indien beschikbaar en volgen anders de rel: results link; ga er niet van uit dat een inline resultaat altijd aanwezig is.
Alle responsvelden voor indiening
| Veld | Omschrijving |
|---|---|
idstring | Download taak ID. |
sourcestring | youtube_download. |
statusstring | in afwachting van de aanvaarding van de opdracht. |
created_atstring | Job creation time in ISO 8601 formaat. |
usage.creditsnumber | 0 bij inzending. Downloads worden berekend door geleverde data volume na voltooiing. |
linksarray | Volg de selflink voor de functiestatus en de resultatenlink voor voltooide output. |
links[].relstring | zelf of resultaten. |
links[].hrefstring | URL om te vragen met dezelfde API sleutel. |
links[].methodstring | GET. |
Voltooide mediabestandsvelden
| Veld | Omschrijving |
|---|---|
results[0].file_urlstring | Locatie van het mediabestand in uw opslagruimte. |
results[0].file_sizeinteger | Media bestandsgrootte in bytes. |
results[0].downloaded_bytesinteger | Bezorgde media bytes die gebruikt worden voor facturering. |
results[0].md5string | MD5 checksum van het mediabestand. |
results[0].resolutionstring · nullable | Videoresolutie, of null voor audio-only uitgang of niet-beschikbare hoogte. |
results[0].durationnumber · nullable | Duur in seconden indien beschikbaar. |
results[0].output_formatstring | Uitvoerbestandsformaat. |
results[0].fpsnumber · nullable | Framesnelheid indien beschikbaar. |
results[0].video_codecstring · nullable | Videocodec indien beschikbaar. |
results[0].audio_codecstring · nullable | Audiocodec indien beschikbaar. |
results[0].dynamic_rangestring · nullable | Video dynamisch bereik indien beschikbaar. |
results[0].metadataobject · optional | Metadata file_url, file_size en md5 wanneer upload_metadata true is. Metadata bytes zijn uitgesloten van downloadkosten. |
De velden hierboven beschrijven het standaard JSON antwoord. Format opties zijn van toepassing op de levering record, niet het media bestand. JSON, platte tekst en Markdown-formaten.
Async & batch lifecycle
Indiening geeft een ontvangstbewijs terug, geen resultaten. Async creëert één taak; batch geeft een aparte taak terug in queries[] voor elke geaccepteerde vraag. Traceer en haal elke taak zelfstandig op.
Verzenden naar data.flashdata.dev; lees jobstatus en resultaten van api.flashdata.dev met dezelfde X-API-Key. De gekoppelde API basisvoorbeelden gebruiken Python en cURL.
1. De taak IDs opslaan
Stuur één download met Async, of zet meerdere downloadverzoeken in een Batch queries array. Elke ingang heeft params.storage nodig. Bewaar elke teruggekeerde baan ID.
2. Status controleren
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: peiling met vertraging en respectRetry-Afterwanneer aanwezig.completed: resultaten halen.failed: inspectiejob.error.Lees job.status, niet de status van het inzendingsbewijs.
Controleer status · Python en cURL
Job status API referentie3. Resultaten ophalen
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsNa voltooiing, authenticeer het resultaat gelezen, dan halen de 302 opslag URL zonder uw API sleutel. Bewaar de JSON binnen 24 uren na voltooiing.
De JSON beschrijft de media die in uw opslagruimte worden geleverd. Toegang tot het mediabestand.
Resultaten · Python en cURL ophalen · Antwoordformaten
Resultaat download API referentie
Bestudering en het ophalen van bestaande resultaten verbruiken geen query credits. Een polling timeout annuleert de taak niet: houd de ID in plaats van het indienen van dubbele factureerbare werk. Foutcodes en opnieuw proberen gedrag.
Webhooks bij voltooiing
Abonneren per query
Instellen callback_url op het hoogste niveau van een async-verzoek, of binnen elke query in een partij, buiten params. Er is geen afzonderlijk verzoek om webhook-registratie vereist.
Gebruik een publieke HTTPS URL op poort 443. FlashData POST een melding voor elke taak bereiken completed of failed; het evenement bevat links, niet het resultaat zelf.
Bevestigen en verifiëren
Terugkeer 2xx na het duurzaam accepteren van de gebeurtenis. Dedupliceren door delivery_id, ook verzonden als X-Delivery-Id. Redirects worden niet gevolgd.
Mislukte leveringen opnieuw proberen met exponentiële backoff, tot 8 probeert totaal en maximaal 24 uren na voltooiing. Blijf peilen als een terugval.
De terugbellen zijn niet ondertekend. Bevestig de taak ID, bron- en terminalstatus via de geauthentiseerd status-eindpunt vóór de verwerking van de kennisgeving. De levering ID is voor deduplicatie, geen bewijs van authenticiteit.
Voorbeeld webhook event en velden
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_download",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Veld | Omschrijving |
|---|---|
delivery_idstring | Stabiele leveringsidentificatiecode. Notificatieberichten dedupliceren met deze waarde; het wordt ook verzonden in de X-Delivery-Id header. |
idstring | Job ID. |
sourcestring | Gevraagde databron. |
statusstring | voltooid of mislukt. |
linksarray | Status en resultaat links. Meldingen bevatten geen resultaatinhoud of een API-sleutel. |
links[].relstring | zelf of resultaten. |
links[].hrefstring | Absolute Management API URL; authenticeer met je API sleutel. |
links[].methodstring | GET. |
Bulk-bestandsverwerking
Upload één video ID per regel en maak de Bulk job met bron: youtube_download. Gedeelde opties zijn van toepassing op elke ID in het bestand.
Plaats de vereiste opslagbestemming in options.storage en media-instellingen in options. Single-job en Batch downloads gebruiken params.storage in plaats daarvan.
Mediabestanden worden geleverd in uw cloudopslag. Het afgeronde Bulk resultaat bevat een manifest en resultaat delen die de downloads beschrijven. Bewaar het manifest en onderdelen binnen 24 uren nadat de volledige Bulk-taak is voltooid.
Bulk verwerking API · Python en cURL · Batch JSON verzoeken
Bouw een Bulk workflow voor deze bron · Pauze, hervatten en herstellen
Bestemming opslag
Includeren params.storage in elk download verzoek. Instellen storage_url naar uw emmer of container naam en leveren referenties met schrijf toegang. Bewaar uw opslaggegevens op uw server.
{
"storage_type": "s3_compatible",
"storage_url": "your-media-bucket",
"object_prefix": "archive/YYYYMMDD",
"endpoint_url": "https://your-s3-endpoint.example.com",
"region": "your-provider-region",
"access_key": "<storage-access-key>",
"secret_key": "<storage-secret-key>"
}object_prefix standaardinstellingen voor YYYYMMDD, vervangen door de UTC upload datum. Gebruik een vaste map of een template zoals archive/YYYYMMDD.
s3- Levering access_key en secret_key met schrijftoegang. Stel de regio in voor de AWS-regio van uw emmer.
s3 voorbeeld
{ "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.
s3_compatible voorbeeld
{ "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.
azure voorbeeld
{ "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.
bos voorbeeld
{ "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.
cos voorbeeld
{ "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.
gcs voorbeeld
{ "storage_type": "gcs", "storage_url": "your-media-bucket", "service_account": { "project_id": "your-project-id", "client_email": "[email protected]", "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.
oss voorbeeld
{ "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.
tos voorbeeld
{ "storage_type": "tos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "cn-beijing" }
Het resultaat file_url identificeert een object in uw opslagruimte. Privé-objecten vereisen een vergunning voor uw opslagprovider of een ondertekende URL; de FlashData API sleutel geeft geen toegang tot uw emmer.
Voor een volledige inzending, peiling en download workflow, zie Download YouTube audio naar Amazon S3.
Bestandsaflevering
De job is rel: results eindpunt defaults naar een redirect naar resultaat JSON, geen MP4 download. FlashData uploadt de werkelijke media naar de door u geleverde emmer of container. Mediabehoud volgt het beleid van uw emmer; het resultaat van de job JSON verloopt 24 uren na voltooiing.
results[0].file_url identificeert het object maar is niet automatisch een openbaar of ondertekend URL. Toegang tot private media met uw opslag SDK, of het genereren van een kortstondige ondertekend URL op uw eigen server. Stuur de FlashData API sleutel niet naar uw opslagprovider.
Inschakelen upload_metadata om een {video_id}_meta.json Metgezel in hetzelfde voorvoegsel. De locatie en het controlesom worden weergegeven onder results[0].metadata.
De Browser-downloadmodus van de console is apart. Publieke API downloads gebruiken uw eigen opslagruimte; bevatten geen console-only browser_delivery instellingen.
Foutherstel
Voor het uploaden van storingen of opslag 403, controleer de provider, emmer, regio, eindpunt en object-write permissies. Een onbereikbaar of privé file_url betekent niet dat de upload mislukt is: controleer het object via uw opslagprovider.
Een verwijderde of niet-beschikbare video kan niet worden teruggevonden door peiling. Voor niet-beschikbare formaten, inspecteer Metadataformaten, ontspannen kwaliteit beperkingen of verwijderen van de geavanceerde selector. Audio-only-verzoeken vereisen m4a, mp3 of opus; videoverzoeken vereisen mp4, webm of mkv.
Als het resultaat JSON verlopen is, controleer dan eerst uw emmer voor de geleverde media. Herinzending creëert een nieuwe download en kan een andere lading oplopen; het herstelt het oude resultaat JSON niet.
Gebruik de gedeelde foutreferentie voor authenticatie, saldo, verzoek-formaat en snelheidslimietfouten. Een inzending timeout kan nog steeds een baan hebben gecreëerd; controleer bestaand werk voordat opnieuw te proberen.
Fouten en statuscodes · Wanneer opnieuw proberen · Maximumtarieven
Stapsgewijze handleiding: Download één video en verifieer levering
Prijzen
| Plannen | Gebruikspercentagesper geleverde GB | Abonnementen | Inclusief credits per facturatieperiode |
|---|---|---|---|
| Betalen naar gebruik | US$ 0,10 | Geen maandelijkse kosten | Opwaarderen wanneer nodig |
| Micro | US$ 0,08 | US$ 49,00 / maand | 1.000 credits (US$ 50,00 of API usance) inclusief |
| Starter | US$ 0,07 | US$ 199,00 / maand | 4.000 credits (US$ 200,00 of API usance) inclusief |
| Pro | US$ 0,06 | US$ 499,00 / maand | 10.000 credits (US$ 500,00 of API usance) inclusief |
| Scale | US$ 0,05 | US$ 999,00 / maand | 20.000 credits (US$ 1.000,00 of API usance) inclusief |
| Business | US$ 0,04 | US$ 1.999,00 / maand | 40.000 credits (US$ 2.000,00 of API usance) inclusief |
Eén accountabonnement. Gedeelde credits voor alle drie de producten. Gebruik dat door inbegrepen credits wordt gedekt, wordt niet opnieuw in rekening gebracht.
Lopende prijzen en maxima van het plan