# FlashData YouTube Download API

YouTube video veya sesinizi bulut depolamanıza indirin. Karar, format ve klip süresi seçin, sonra asynchronous işi tamamlanmadan takip edin.

Canonical referans: https://flashdata.dev/tr/docs/sources/youtube_download
İnceleme: 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries
Kimlik doğrulama: X-API-Key: YOUR_API_KEY
Modes Modes: [Async](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch) · [Bulk](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md)

Gerekli kaynak izni izni: youtube_download

Değişimi Değiştir YOUR_API_KEY Biriyle birlikte API Bu kaynak izni ve mevcut kredilere sahip anahtar. sunucunuzda veya acente ev sahibinizde yükleme talepleri.

[Varsayılan kimlik doğrulamayı ayarlayın](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)

[Bir videoyu indirin ve teslimatını doğrulayın](https://flashdata.dev/tr/docs/guides/download-video-recipe/reference.md)

[YouTube video indirme API'si — Python örnekleri](https://github.com/flashdatadev/youtube-video-download-api)

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

## Bir istek gönder

### 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>

## Parametreler

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

### İstek gövdesi

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Evet Evet Evet | — | youtube_download'a ayarlayın.  |
| <a id="parameter-video_id"></a> video_id | string | Evet Evet Evet | Set Not set Not set | 11-character YouTube video ID, FUfGcZ092b0 gibi. Mektupları kabul eder, sayılar, işaretler ve hipnozlar. Min uzunluğu: 11. Max uzunluğu: 11. Desen: ^[A-Za-z0-9_-]{11}$ |
| <a id="parameter-params"></a> params | object | Evet Evet Evet | — | Settings bu istek için.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Hayır yok hayır | Set Not set Not set | Async ve sadece toplu. Halk Halk Halkı HTTPS Tamam tamamlanma tamamlanma tamamlanma tamamlandı URL limanda 443, yukarı 2,048 karakterler. Kullanıcı Bilgileri veya URL parçaları yok. Omit, null veya bildirim için boş bir dize kullanın. Bir partide, bunu her sorguda, params dışında ayarlayın.  |

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

### Video & Ses

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-download_type"></a> params.download_type | string | Hayır yok hayır | "audio_video" | audio_video video ve ses birleştirir; video sadece videoyu seçer; ses sadece ses seçin. İzin verin: "audio_video", "video", "audio". Min uzunluğu: 1. Max uzunluğu: 11. |
| <a id="parameter-params-video_quality"></a> params.video_quality | string | Hayır yok hayır | "<=720" | Video çözünürlüğü seçimi. Omit for audio-only downloads. İzin verin: "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 uzunluğu: 1. Max uzunluğu: 40. |
| <a id="parameter-params-fps"></a> params.fps | string | Hayır yok hayır | Set Not set Not set | Frame-rate constraint: >=, <= veya ==, 1'dan 240'ye bir değer izledi. Omit for audio-only downloads. Min uzunluğu: 1. Max uzunluğu: 6. Desen: ^(?:>=\|<=\|==)(?:[1-9]\d?\|1\d\d\|2[0-3]\d\|240)$ |
| <a id="parameter-params-audio_language"></a> params.audio_language | string | Hayır yok hayır | "default" | Audio track seçimi. audio_video ve ses için uygun. İzin verin: "default", "original". Min uzunluğu: 1. Max uzunluğu: 8. |
| <a id="parameter-params-audio_quality"></a> params.audio_quality | string | Hayır yok hayır | "best" | Ses sadece kbps veya en iyi. Sayısal seçimler dize olarak gönderilmelidir. Video indirmeleri için Omit. İzin verin: "best", "320", "256", "192", "128". Min uzunluğu: 1. Max uzunluğu: 10. |
| <a id="parameter-params-output_format"></a> params.output_format | string | Hayır yok hayır | mp4 (video) / m4a (audio) | Video: mp4, webm veya mkv. Ses: m4a, mp3 veya opus. İzin verin: "mp4", "webm", "mkv", "m4a", "mp3", "opus". Min uzunluğu: 1. Max uzunluğu: 10. |
| <a id="parameter-params-yt_dlp_format"></a> params.yt_dlp_format | string | Hayır yok hayır | Set Not set Not set | Gelişmiş format seçici, 1'dan 1,024 karakterlerini kırıldıktan sonra. Kontrol karakterleri reddedilir. Overrides video_quality, fps ve audio_language, hangi değerleri görmezden gelindi; çıktı formatı ve klipler hala geçerlidir. Min uzunluğu: 1. Max uzunluğu: 1024. |
| <a id="parameter-params-upload_metadata"></a> params.upload_metadata | boolean | Hayır yok hayır | false | Bir metadata JSON dosyasını depolamanızda medya dosyasıyla birlikte yükleyin.  |

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

### Clipping

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-start_at"></a> params.start_at | string | Hayır yok hayır | Set Not set Not set | Video, H:MM:SS veya HH:MM:SS formatında 00:00:00'dan 12:00:00'ye başlıyor. 00:00:00'ye sadece end_at temin edilir. Min uzunluğu: 1. Max uzunluğu: 8. Desen: ^\d{1,2}:[0-5]\d:[0-5]\d$ |
| <a id="parameter-params-end_at"></a> params.end_at | string | Hayır yok hayır | Set Not set Not set | H:MM:SS veya HH:MM:SS formatı, 12:00:00'ye kadar. start_at'den daha geç olmalıdır. Min uzunluğu: 1. Max uzunluğu: 8. Desen: ^\d{1,2}:[0-5]\d:[0-5]\d$ |

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

### Depolama destinasyonu

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-storage"></a> params.storage | object | Evet Evet Evet | — | Tamamlanan medya dosyaları için tarih. Sadece listelenen depolama alanları kabul edilir.  |
| <a id="parameter-params-storage-storage_type"></a> params.storage.storage_type | string | Evet Evet Evet | — | Depolama sağlayıcısı: s3, s3_compatible, oss, gcs, azure, cos, bos veya tos.  |
| <a id="parameter-params-storage-storage_url"></a> params.storage.storage_url | string | Evet Evet Evet | — | Boş olmayan kova veya konteyner adı, 1,024 karakterlerine kadar. Beyaz uzayı çevrilir. s3 için, URL veya klasör yolu olmadan geçerli bir AWS kova adı kullanın; klasörler object_prefix'ya ait.  |
| <a id="parameter-params-storage-object_prefix"></a> params.storage.object_prefix | string | Hayır yok hayır | "YYYYMMDD" | Object-key prefix, 1 ile 512 karakterlere. Her ince parçalı segment ASCII mektuplarını, basamakları, dotları, alt kesimleri ve hipnozları kabul eder; boş segmentler, . ve .. Hiç lider yok. Beyaz uzay ve bir iz kırıklığı kaldırılmıştır. YYYYMD, archive/YYYYMMDD.D dahil UTC yükleme tarihini kullanır.  |
| <a id="parameter-params-storage-access_key"></a> params.storage.access_key | string | Hayır yok hayır | — | S3, S3- uyumlu, OSS, COS, BOS veya TOS için anahtar; secret_key ile çiftleştirildi.  |
| <a id="parameter-params-storage-secret_key"></a> params.storage.secret_key | string | Hayır yok hayır | — | S3, S3- uyumlu, OSS, COS, BOS veya TOS için gizli anahtar.  |
| <a id="parameter-params-storage-endpoint_url"></a> params.storage.endpoint_url | string | Hayır yok hayır | — | Halk Yayını HTTPS uç nokta için S3- uyumlu depolama veya OSS. COS, BOS ve TOS onu bölgeden alır.  |
| <a id="parameter-params-storage-region"></a> params.storage.region | string | Hayır yok hayır | — | COS, BOS ve TOS için gerekli; ayrıca S3 ve S3- uyumlu indirmeler için tedarik edin. COS kova isimleri APPID içerir.  |
| <a id="parameter-params-storage-service_account"></a> params.storage.service_account | object | Hayır yok hayır | — | GCS hizmet hesabı: project_id, client_email ve PEM private_key.  |
| <a id="parameter-params-storage-account_name"></a> params.storage.account_name | string | Hayır yok hayır | — | Azure depolama hesabı adı. storage_url'daki konteyner adını kullanın.  |
| <a id="parameter-params-storage-sas_token"></a> params.storage.sas_token | string | Hayır yok hayır | — | Write-specific Azure konteyner SAS with expiry and sign.  |

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

## Sonuç okuyun

İş tamamlandıktan sonra, tasarruf edin JSON sonuçlarından bağlantı response.json. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Video indirmeden veya başka bir istek yapmadan dosya ayrıntıları okur.

### 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))
```

## Örnekleme

Kayıt örneği; alanlar ve sayılar kaynağına bağlıdır ve talep edilen girdiye bağlıdır.
```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"
    }
  ]
}
```

## Yanıt alanları

| Field | Tür Türü Tipi | Description Description Description |
| --- | --- | --- |
| id | string | İş ID'u indirin. |
| source | string | youtube_download. |
| status | string | İş kabul edildiğinde bekleyin. |
| created_at | string | ISO 8601 formatında iş yaratma zamanı. |
| usage.credits | number | 0 teslimiyette. İndirmeler tamamlandıktan sonra veri hacmi teslim edilir. |
| links | array | İş durumu ve tamamlanmış çıktı için kendi bağlantısını takip edin. |
| links[].rel | string | Kendi veya sonuçları. |
| links[].href | string | URL Aynı şekilde sorgulamak için API anahtar. |
| links[].method | string | GET. |

- İndirmeler arka plan işleri olarak çalışır. Teklif cevabı bir iş ID içerir; medya dosyasını kapsamaz. Tamamlanana kadar iş durumunu takip edin, sonra depolamanıza teslim edilen dosyaları tarif edin. /v1/queries veya /v1/queries/batch'ye indirmeleri gönderin; /v1/queries/realtime indirme taleplerini kabul etmez.

## Yanıt biçimleri

Yanıtlar JSON'u varsayılan olarak kullanır. Bu opsiyonel başlıkları ile başka bir format seçin.

- Accept: application/json (varsayılan) veya veya veya text/plain. Plain text aynı alanları okunabilir, okunabilir bir düzende sunar.
- X-Respond-With: markdown. Orijinal alanlarda başlangıç bırakın. Markdown, yanıt formatı ile çalışır.

Markdown, indirmenin ortaya çıkmasını gösterir; medya dosyaları orijinal formatlarını tutar. Receipts ve iş durumu Accept'u sadece destekliyor.

Aşağıdaki alanlar varsayılan JSON yanıtını tanımlar.

[İstek ve yanıt formatı örnekleri](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#completed-results)

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

## Depolama destinasyonu

Single-job ve Batch indirmeleri params.storage gerektirir; Bulk indirmeleri options.storage. storage_url, kova veya konteyner adıdır. Yazma erişimi ile bilgi sahibi olun ve onları sunucunuzda tut.

### s3

Supply access_key ve secret_key yazı erişimle. Bölgeyi kovanızın AWS bölgesine ayarlayın.

```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 ve bir halk HTTPS endpoint_url. Sağlayıcınız tarafından gerekli olan bölge ayarlayın; Cloudflare R2 otomatik kullanır.

```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 ve sas_token, yaz izni ile bir konteyner SAS (sp dahil), kaynak sr=c, expiry se, sürüm sv ve imza sig. storage_url is the container name. endpoint_url, access_key veya secret_key göndermeyin.

```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

Supply access_key, secret_key ve bölge: bj, su veya hkg. Son nokta, omized sırasında bölgeden türetilmiştir. Dots olmadan bir kova adı kullanın.

```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 ve ap-hongkong gibi bir bölge. storage_url, APPID ekini içermelidir. endpoint_url göndermeyin; bölgeden türetilmiştir.

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

### gcs

service_account ile project_id, client_email (a .gserviceaccount.com adresi) ve PEM private_key hizmet hesabınızdan. Hesap, kovaya erişim yazmalıdır. access_key, secret_key, bölge veya endpoint_url göndermeyin.

```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 ve kova bölgesinin halk HTTPS endpoint_url.

```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

Supply access_key, secret_key ve bölge bir cn-, ap-, eu- veya biz önceden ek. Son nokta, omized sırasında bölgeden türetilmiştir. Dots olmadan bir kova adı kullanın.

```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 temelleri

Yukarıdaki istek oluşturucu ve örnekler bu kaynağın parametrelerini kullanır. Python ve cURL örneklerini paylaşılan teslimiyet, durum ve sonuç adımları için kullanın. Bir Batch vücut, sorgu içeren bir JSON nesnedir; her öğe kendi işini döndürür ID.

- [Async isteği ve makbuz](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async)

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

- [Check job status](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#status)

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

- [Erişim tamamlanmış sonuçlar](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON talep ediyor](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)
- [Bulk işleme API’si](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md)
- [Bu kaynak için bir Bulk iş akışı inşa edin](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md?source=youtube_download#playground)
- [Müşteri Açık API](https://flashdata.dev/docs/openapi.json)

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

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

## Tamamlanan bildirimleri tamamlayın

- [Satın alın ve doğrulama webhooks](https://flashdata.dev/tr/docs/guides/async-batch/reference.md#webhooks)

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

## Sorun Giderme

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md#status-codes)
- [Yeniden deneme ne zaman](https://flashdata.dev/tr/docs/errors/reference.md#retries)

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

## Dosya teslimatı

Download gerçek zamanlı destek vermez.

Medya yapılandırılmış depolamanıza yükleniyor; sonuç JSON bu dosyaları anlatıyor. Özel medya depolama kimlik doğrulamanızı kullanır. JSON sonuçları tamamlandıktan sonra 24 saatlerini sona erdirir; medya depolama tutma politikasını takip eder.

## İlgili APIs

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