AltyaziDB API v1.3

AltyaziDB API, Türkiye'nin en temiz altyazı veritabanına erişmeniz için tasarlanmış yüksek performanslı bir REST servisidir.

Kullanıcı ve Kota Sorgulama

Geliştiricilerin kalan API hız sınırlarını (Rate Limit) canlı olarak kontrol etmesini sağlar.

Altyazı Arama

IMDb ID, TMDB ID veya Kodi gibi istemciler için başlık/yıl fallback'i kullanarak belirli bir yapıma ait altyazıları listeler.

1. İstek Parametreleri (Request)

Örnek Arama İstekleri

GET /api/v1/search?imdb_id=tt37529347&lang=tr&season=1&episode=2
GET /api/v1/search?tmdb_id=12345&lang=tr
GET /api/v1/search?title=Breaking%20Bad&year=2008&type=series&lang=tr&season=1&episode=1
GET /api/v1/search?title=Bagdad%20Cafe&year=1987&type=movie&version_group=BluRay&lang=tr

2. Yanıt Alanları (Response Model)

Başarılı bir arama sonucunda dönen JSON objesindeki veri modeli aşağıdaki gibidir. Yanıtın filters.version_groups alanı mevcut sonuçlardaki BluRay, UHD, WEB-DL gibi üst filtreleri listelemek için kullanılabilir.

İçerik Arama — Film/Dizi Ayrımlı

Başlık ve yıl bilgisiyle AltyaziDB içerik arşivinde film veya dizi ayrımı yaparak içerik araması yapar. Bu endpoint özellikle medya oynatıcıların IMDb/TMDB ID göndermediği durumlarda doğru içeriği seçmek için kullanılabilir.

Örnekler

GET /api/v1/content_search?title=Bagdad%20Cafe&year=1987&type=movie
GET /api/v1/content_search?title=Breaking%20Bad&type=series

Yanıt Örneği

{
  "success": true,
  "query": {
    "title": "Bagdad Cafe",
    "year": 1987,
    "content_type": "movie"
  },
  "data": [
    {
      "id": 724,
      "title": "Bagdad Cafe",
      "slug": "bagdad-cafe",
      "content_type": "movie",
      "year": "1987",
      "release_date": "1987-11-12",
      "imdb_id": "tt0095801",
      "tmdb_id": "12345",
      "date": "2026-06-09 21:00:00"
    }
  ]
}

Son Eklenenler

Sisteme eklenen en güncel altyazıları tarihe göre tersten listeler. Dönen veri modeli Arama uç noktası ile aynıdır.

Arşiv / Orijinal Dosya İndirme

Altyazının sisteme yüklendiği orijinal dosyayı indirmenizi sağlar. Bu dosya .zip, .rar veya doğrudan .srt olabilir.

Subtitle Stream / Arşivden Altyazı Çıkarma

ZIP, RAR veya doğrudan SRT/VTT/ASS/SUB dosyasından medya oynatıcı uyumlu düz altyazı çıkarır. Stremio, Nuvio, Kodi ve Jellyfin gibi istemciler için önerilen endpoint budur.

Örnek Kullanım

GET /api/v1/subtitle?sub_id=109617
GET /api/v1/subtitle?sub_id=12345&season=1&episode=2
GET /api/v1/download?sub_id=109617&format=subtitle

Bu endpoint JSON döndürmez; başarılı olduğunda doğrudan altyazı dosyasını stream eder. Hata durumunda JSON hata cevabı döner.

Paket İçinden Bölüm Ayıklama

Bir sezon paketinin (ZIP veya RAR) içinden sadece istenen bölümün (.srt / .vtt / .ass / .ssa / .sub) dosyasını anında ayıklar ve RAW formunda medya oynatıcıya stream eder.

Altyazı Yükleme (Upload)

Sisteme doğrudan altyazı dosyası (zip, rar, srt) yüklemenizi sağlar.

1. İstek Parametreleri (POST)

curl -X POST "https://altyazidb.com/api/v1/upload" \
-H "X-API-Key: ANAHTARINIZ" \
-F "file=@/bilgisayar/yolu/altyazi.zip" \
-F "imdb_id=tt37529347" \
-F "lang=tr" \
-F "season=1" \
-F "episode=PAKET" \
-F "fps=23.976" \
-F "translator=NETRip" \
-F "release=WEB-DL" \
-F "ai_ceviri=1" \
-F "foreign_parts=0"

{
  "success": true,
  "message": "Altyazı başarıyla yüklendi.",
  "sub_id": 6615,
  "post_id": 128
}

Etkileşimler (Favori & Rapor)

Altyazılar ile etkileşime girmek için kullanılan uç noktalardır.

Favoriye Ekle / Çıkar

Hatalı Altyazı Raporlama

Hata Kodları