Zamanlı altyazı

GET/v1/media/subtitles1 kredi

YouTube, TikTok, Instagram, X, Facebook, LinkedIn, Twitch ve Kick klipleri, Reddit ve Rumble video gönderilerindeki konuşmayı zamanlı satırlar olarak verir: JSON ya da SRT veya WebVTT dosyası. Platformun zamanlamalı kendi altyazı izi varsa (YouTube, TikTok, Reddit, Rumble, LinkedIn ve Facebook altyazı dosyaları) o kullanılır (`origin: source`); yoksa ses, satır zamanlarıyla konuşma tanımadan geçirilir (`origin: asr`). Bize ait bir rota: ScrapeCreators'ın altyazı sözleşmesi yoktur.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Video gönderisinin URL'si, örneğin `https://www.youtube.com/watch?v=dQw4w9WgXcQ`; bir TikTok videosu, bir Instagram reels'i veya gönderisi, bir X gönderisi, bir Facebook videosu veya reels'i, bir LinkedIn gönderisi, bir Twitch veya Kick klibi, bir Reddit gönderisi ya da bir Rumble videosu.
formatisteğe bağlı	string	`json` satırları zarf içinde döndürür; `srt` ve `vtt` dosyanın kendisini döndürür (`application/x-subrip`, `text/vtt`, ek olarak).Varsayılan: `json`Kabul edilen değerler:`jsonsrtvtt`
languageisteğe bağlı	string	Tercih edilen altyazı izinin iki harfli dil kodu (YouTube, TikTok, Reddit).
allow_long_transcriptionisteğe bağlı	boolean	`true`, 120 sn'den uzun videoların konuşma tanımasına başlayan dakika başına 10 krediyle izin verir.Varsayılan: `false`
indexisteğe bağlı	integer	Yalnızca Instagram: karuseldeki kaçıncı video (1 = ilki).Varsayılan: `1`

02Fiyatlandırma

Platformun transkript fiyatı: bir altyazı izi 1 kredi; konuşma tanıma 120 sn'ye kadar 1 kredi, daha uzun bir video `allow_long_transcription=true` olmadan ücretsiz 400'dür (başlayan her dakika 10 kredi); konuşma veya iz yoksa 0; her hata ücretsizdir. `srt` ve `vtt` için krediler `X-Credits-Charged` ve `X-Credits-Remaining` başlıklarındadır.

03İstek

curl "https://api.scrapesocial.ai/v1/media/subtitles?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&format=srt" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/media/subtitles?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "platform": "youtube",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "origin": "source",
  "language": "en",
  "duration_seconds": null,
  "segments": [
    {
      "index": 1,
      "start": 18.8,
      "end": 21.8,
      "text": "We're no strangers to"
    },
    {
      "index": 2,
      "start": 21.8,
      "end": 25.96,
      "text": "love. You know the rules and so do"
    }
  ]
}

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

JSON yanıtı `platform, url, origin` (`source`, `asr` ya da hiçbir şey bulunmadıysa null), `language` (biliniyorsa ISO 639-1), `duration_seconds` (kaynak söylemiyorsa null), `segments[{index, start, end, text}]` alanlarından oluşur; süreler saniyedir (3 ondalık). Dosyalarda satırlar 1'den numaralanır ve süreler milisaniyeye yuvarlanır; WebVTT metni kaçışlanır (`&`, `<`, `>`). Konuşma tanıma uzun sesi parçalara böler ve her parçanın satırlarını parçanın başlangıcı kadar kaydırır; bu yüzden bir satır parça sınırında bölünebilir. Altyazısı veya konuşması olmayan bir video 0 krediyle boş liste (ya da boş dosya) döndürür. Desteklenmeyen bir alan adı ücretsiz 400 `unsupported_platform` döndürür.

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.