İçeriğe geç
TR
API anahtarı al
Belgeleri incele

API başvurusu

YouTube Transcript API

API anahtarı alın

Erişim tarihi: YouTube transkriptleri ve tam bir transkript. Otomatik kuyruklar varsayılan olarak seçilir.

İstek oluştur

11-character ID videodan URL, tam URL değil.

En-orig'i denemek için boş bırakın, sonra en, ve bir yol geri dönün. Ya da bir koda gir ya da 10'ye ayrı kodlar komünler tarafından ayrılır.

Caption track auto
POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_transcript",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "language": "en",
        "auto": True,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
HTTP yanıtlarında sonuçlarX-API-Key doğrulama

Parametreler

Send Send Gönder source Ve ve video_id Üst düzeyde. Kaynak seçenekleri içeri girer params. Seçmeli alanlar ihmal edilebilir.

İstek gövdesi

sourcestring / Zorunlu
youtube_transcript'a ayarlayın.
video_idstring / Zorunlu
11-character YouTube video ID, FUfGcZ092b0 gibi. Mektupları kabul eder, sayılar, işaretler ve hipnozlar.
Tam olarak 11 karakterler karakterler karakterlerVarsayılan: Set Not set Not set
Kabul edilen format^[A-Za-z0-9_-]{11}$
paramsobject / İsteğe bağlı
Settings bu istek için.
Varsayılan: {}
callback_urlstring · nullable / İsteğe bağlı
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.
Varsayılan: Set Not set Not set

Caption Selection

params.languagestring | array / İsteğe bağlı
İngilizce için (en-orig, sonra). Auto=true ile, her kod ilk önce -veyaig takip etmeye çalışır, sonra istenen kodu. Explicit -orig kodları ve auto=false tam olarak kalır. Diziler 1–10 farklı diller talep eder.
Varsayılan: en-orig → en
params.autoboolean / İsteğe bağlı
true, YouTube-provided kuyrukları seçer; false yüklemeleyici-provided captions. Bu, isimsiz kökenini seçer, dil tespiti veya yeni transkripsiyon değil.
true veya veya veya falseVarsayılan: true

Yanıt

Realtime döndürür status: done. Kaynak çıktısını okuyun results[0]; usage.credits Yükyü kaydeder.

Katlı metin ve fullText'yu katıldıkları için okuyun. Segment başlangıç ve son saniyedir; languageCode ve isAutoGenerated, seçilmiş pisti tanımlar.

Sonuç okuyun

JSON yanıtını response.json olarak kurtarın. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Sadece Python'un standart kütüphanesini kullanır ve yeni bir istek yapmaz.

read-response.py
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 = {
    "tracks": result.get("tracks", [result]),
    "errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))

Omit dili en-orig'i tercih etmek ve geri dönmek, bir iz geri dönmek. Auto=true ile, her talep edilen kod onu tercih eder -veyaig takip eder, sonra düz kod; açık -veyaig ve otomatik=false tam olarak kalır. Diziler her talep edilen dili ve geri dönüş parçaları ve hataları sırayla deneyin. languageCode, seçilen pisti tanımlar; requestedLanguageCode, farklı olduğu zaman dahil edilir.

Dil dizilerinde alınamayan altyazı parçalarını görmek için errors alanını kontrol edin. Hiçbir altyazı parçası alınamazsa istek başarısız olur ve ayrılan krediler iade edilir. Video verisi çıkarılamadığında veya istek süresi dolduğunda da istek başarısız olur.

true'ye otomatik satırlar için otomatik varsayılan varsayılanlar. false'u yükleyici ayarlar için ayarlayın. API hiçbir zaman kaynakları açıklamaz.

API mevcut YouTube altyazılarını okur; yeni transkript üretmez. Varsayılan yanıt normalize edilmiş JSON metni içerir. Accept ile düz metin, X-Respond-With: markdown ile Markdown seçilebilir. languageName null olabilir.

Birden çok dil dili

Bir dil dizisini parçaları almak ve dil hataları için gönderin. Bu örnek, İngilizce'nin mevcut olmadığını ve İspanyolca olmadığını gösteriyor.

İstek
{
  "source": "youtube_transcript",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "language": [
      "en",
      "es"
    ],
    "auto": true
  }
}
results[0]
{
  "videoId": "jNQXAC9IVRw",
  "isAutoGenerated": true,
  "tracks": [
    {
      "videoId": "jNQXAC9IVRw",
      "languageCode": "en-orig",
      "requestedLanguageCode": "en",
      "languageName": null,
      "isAutoGenerated": true,
      "segments": [
        {
          "start": 0,
          "end": 1.5,
          "text": "Hello world."
        }
      ],
      "fullText": "Hello world."
    }
  ],
  "errors": [
    {
      "languageCode": "es",
      "code": "language_unavailable",
      "message": "Auto-generated subtitles not available for language: es"
    }
  ]
}
Tüm yanıt alanları
FieldDescription Description Description
sourcestringTalep edilen API kaynağı.
statusstringGerçek zamanlı istek başarılı olduğunda yapılır.
created_atstringISO 8601 formatındaki arama süresi.
usage.creditsnumberKrediler talep için ücretlendirilir, planınıza göre.
results[0].videoIdstringİstenen video ID.
results[0].languageCodestringActual selected caption track code, örneğin en-orig.
results[0].languageNamestring · nullableDil ekran adı mevcut olduğunda.
results[0].requestedLanguageCodestring · optionallanguageCode'dan farklı olduğu zaman istenen kod, örneğin en-orig seçildiğinde.
results[0].isAutoGeneratedbooleanSeçilmiş kuyruklar otomatik olarak üretilseydi.
results[0].segmentsarraychronolojik düzenindeki kıvrım segmentleri.
results[0].segments[].startnumberSegment saniyeler içinde zaman başlar.
results[0].segments[].endnumberSegment saniyeler içinde son kez.
results[0].segments[].textstringCaption text.
results[0].fullTextstringTüm segment metni bir transkriptine katıldı.
results[0].tracksarray · optionalDil dizileri için sadece. Talep emrinde mevcut parçalar; her biri yukarıda listelenen tek yol alanları vardır.
results[0].errorsarray · optionalDil dizileri için sadece. İstek siparişinde başarısız diller. Her pist başarılı olduğunda boş.
results[0].errors[].languageCodestringBaşarısız olan talep edilen dil.
results[0].errors[].codestringlanguage_unavailable Seçilmiş takip mevcut olmadığında; retrieval_failed Ne zaman indirilemeyecek veya parsed edilemezdi.
results[0].errors[].messagestringDilin başarısızlığının tanımı.

Yukarıdaki alanlar varsayılan JSON yanıtını tanımlar. JSON, düz metin ve Markdown formatları.

Async bir iş makbu döndürür; toplu bir iş başına döndürür Video ID. Her işin durumunu kontrol edin ve geri dönüş bağlantıları kullanarak sonuçlarını alın.

Async & toplu yaşam döngüsü

Submission bir makbuz döndürür, sonuç vermez. Async bir iş yaratır; toplu ayrı bir iş döndürür queries[] Her kabul edilen sorgu için. Her işi bağımsız olarak takip edin ve alın.

Göndermeye yemin ederim data.flashdata.dev; İş durumunu ve sonuçlarını okuyun api.flashdata.dev Aynı X-API-Key ile. bağlantılı API temelleri Python ve cURL kullanır.

  1. 1. İşi kurtarmak IDs

    Bu kaynağın Async'ye geçiş yaparken istek alanları tut. Batch için, her isteği bir JSON nesnesinin sorgu dizi içine koyun. Her geri dönüş işi ID’yu kurtarın.

    Async isteği ve makbuz · Batch istek vücut isteği

  2. 2. Check durumu kontrol

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: Bir gecikme ve saygı ile anket Retry-After Şu anda. completed: Sonuçlar getir. failed: denetim job.error.

    job.status'u okuyun, teslim makbunun statüsü değil.

    Check durumu · Python ve cURL

    İş durumu API referans
  3. 3. Fetch sonuçları

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    Tamamlandıktan sonra, sonuç okumasını gerçekle, sonra 302 depolama URL'yu API anahtarınız olmadan getirin. JSON'u 24 saat içinde kurtarın.

    Fetch sonuçları · Python ve cURL · Yanıt biçimleri

    Sonuç indir API referans

Mevcut sonuçları araştırmak ve getirmek sorgu kredilerini tüketmiyor. Bir anket süresi işi iptal etmez: Tekrarlanan faturalı işi sunmak yerine ID'yu tut. Hata kodları ve yeniden deneme davranışı.

Tamamlanma webhook’ları

Sorgu başına abone olun

Set Set Set callback_url Bir amin talebinin üst seviyesinde veya Her sorgunun içinde Bir partide, dışarıda params. Ayrı bir webhook kayıt isteği gerekmez. Realtime talepleri çağrıları göndermez.

HTTPS URL port 443. FlashData POSTs her iş için bir bildirim completed veya veya veya failed; Olay bağlantıları içeriyor, sonucun kendisi değil.

Abilgi ve doğrulama

Return Return Return dön 2xx Olayı kabul ettikten sonra. Deduplicate Tarafından delivery_id, Ayrıca, da gönderiler X-Delivery-Id. Emekliler takip edilmez.

Başarısız teslimatlar, üst üste tekrar tekrar tekrar deneme, yukarı yukarı yukarı 8 toplam denemeler Ve çoğu zaman 24 saatler tamamlandıktan sonra. Bir düşüş olarak ankete devam edin.

Callbacks imzalanmamış. İş ID, kaynak ve terminal statüsünü onaylayın Gerçekleştirilmiş durum uç noktası bildirimi işlemeden önce. Teslimat ID, gerçekliğin kanıtı değildir.

Örnek webhook olayı ve alanları
Illustrative tamamlanma bildirim
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "youtube_transcript",
  "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"
    }
  ]
}
FieldDescription Description Description
delivery_idstringStable teslimat tanımlayıcısı. Bu değeri kullanarak bildirimleri karmaşıklaştırın; aynı zamanda X-Delivery-Id başlığında da gönderilir.
idstringİş ID.
sourcestringTalep edilen veri kaynağı.
statusstringTamamlanan veya başarısız oldu.
linksarrayDurum ve sonuç bağlantıları. Bildirimler sonuç içeriğini veya API anahtarını içermez.
links[].relstringKendi veya sonuçları.
links[].hrefstringMutlak Yönetim API URL; API anahtarınızla ilgili.
links[].methodstringGET.

Full webhook sözleşmesi ve URL kısıtlamaları

Bulk dosya işleme

Bir video ID hattı başına yükleyin ve Bulk işi kaynakla oluşturun: youtube_transcript. Paylaşılan seçenekler, dosyadaki her ID'ya uygulanır.

Kaynak seçenekleri: dil, auto. Onları Bulk işi oluştururken seçeneklere koyun.

Tamamlanan koleksiyonu açık ve gzip-comated NDJSON sonuç parçaları olarak alın. Data kaynakları aynı zamanda bulut depolamanıza sonuç parçaları da ayarlayarak verebilir options.result_storage Yarattığı zaman Bulk İş. 24 saat içinde tüm Bulk işi tamamlandıktan sonra ortaya çıkan ve parçalar kurtarın.

Bulk işleme API · Python ve cURL · Batch JSON talep ediyor

Bu kaynak için bir Bulk iş akışı inşa edin · Pause, özgeçmiş ve kurtarma

Hata kurtarma

Talep edilen pist mevcut değilse, Metadata API's transcriptLanguages'u inceleyin ve language/track tipini açıkça talep edin. Mevcut olmayan bir seçimin tekrarlanması bu yolu yaratmayacaktır.

Metadata ile mevcut satır dillerini kontrol edin. Yeni bir istek sorgu kredilerini kullanır; bir pistin değiştirilmesi mevcut bir işi değiştirmez.

Doğrulama için, denge, istek-format ve oran-limit başarısızlıkları, paylaşılan hata referansını kullanın. Bir teslim süresi hala bir iş yaratabilir; yeniden denemeden önce mevcut işleri kontrol edin.

Hatalar ve durum kodları · Yeniden deneme ne zaman · Puan limitleri

Step-by-step rehberi: Bir transkript dili seçin ve takip edin

Fiyatlandırma

PlanlarKullanım oranları1.000 standart istek başınaAbonelik AboneliğiFatura dönemi için krediler dahil
Kullandıkça öde$0,50Aylık ücret yokGerektiğinde bakiye ekleyin
Micro$0,40$49,00 / ay ay ay1.000 kredileri ($50,00 of API kullanımı)
Starter$0,35$199,00 / ay ay ay4.000 kredileri ($200,00 of API kullanımı)
Pro$0,30$499,00 / ay ay ay10.000 kredileri ($500,00 of API kullanımı)
Scale$0,25$999,00 / ay ay ay20.000 kredileri ($1.000,00 of API kullanımı)
Business$0,20$1.999,00 / ay ay ay40.000 kredileri ($2.000,00 of API kullanımı)

Tek hesap planı. Üç üründe ortak kredi bakiyesi. Plana dahil kredilerle karşılanan kullanım yeniden ücretlendirilmez.

Mevcut fiyatlar ve plan limitleri