Video Transkripti
GET/v1/youtube/video/transcript1 kredi
Bir videonun transkriptini altyazı kanalından döndürür: zamanlanmış bölümler, tek bir metin halinde tam metin, kanalın dili ve mevcut altyazı kanallarının listesi.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| urlzorunlu | string | YouTube video URL'si: watch, youtu.be, Shorts, live veya embed bağlantısı. |
| languageisteğe bağlı | string | Altyazı kanalının dil kodu (ör. `en`, `es`). Verilmezse İngilizce kullanılır ve otomatik oluşturulan kanal tercih edilir. |
| cache_max_ageisteğe bağlı | string | Uyumluluk için kabul edilir; her çağrı güncel veriyle yapılır, bu yüzden değer yanıtı değiştirmez.Kabul edilen değerler:1d3d7d14d30d |
02Fiyatlandırma
Transkript döndüğünde 1 kredi; video istenen dilde altyazıya sahip değilse 0 kredi.
03İstek
curl "https://api.scrapesocial.ai/v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
04Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"type": "video",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"transcript": [
{
"text": "[Music]",
"startMs": "320",
"endMs": "14580",
"startTimeText": "0:00"
},
{
"text": "We're no strangers to",
"startMs": "18800",
"endMs": "25960",
"startTimeText": "0:18"
}
],
"transcript_only_text": " [Music] \n We're no strangers to \n love. You know the rules and so do \n I. I feel commitments from what I'm \n thinking \n of. You wouldn't get this from any other \n guy. I just want to tell you how I'm \n feeling. Got to make you understand. \n Never going to give you up. I'm going to \n let you down. I'm going to run around \n and desert you. I'm g…",
"language": "English",
"videoId": "dQw4w9WgXcQ",
"captionTracks": [
{
"baseUrl": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=Njfeasj0HYX_6LUP7JjxiQw&caps=asr&opi=112496729&xoaf=5&xowf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1792973222&sparams=ip,ipbits,expire,v,ei,caps,opi,xoaf&signature=B60BC17575C8DC4FEC9D59CAD2FD370CB7761D84.17DDA628EDFDB5719F35F9B6DA727B904ECAEFCF&key=yt8&lang=en",
"name": {
"simpleText": "English"
},
"vssId": ".en",
"languageCode": "en",
"isTranslatable": true,
"trackName": ""
},
{
"baseUrl": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=Njfeasj0HYX_6LUP7JjxiQw&caps=asr&opi=112496729&xoaf=5&xowf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1792973222&sparams=ip,ipbits,expire,v,ei,caps,opi,xoaf&signature=B60BC17575C8DC4FEC9D59CAD2FD370CB7761D84.17DDA628EDFDB5719F35F9B6DA727B904ECAEFCF&key=yt8&kind=asr&lang=en",
"name": {
"simpleText": "English (auto-generated)"
},
"vssId": "a.en",
"languageCode": "en",
"kind": "asr",
"isTranslatable": true,
"trackName": ""
}
]
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}05Notlar
Video istenen dilde altyazı kanalına sahip değilse çağrı 200 döner, `transcript` ve `language` null gelir ama `captionTracks` yine listelenir; böylece başka bir dil seçebilirsiniz. `startMs` ve `endMs` metin (string) olarak gelir; `language` dil kodu değil, kanalın adıdır (ör. `English`).
06Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.