Geliştirici Desteği

AniSub Public API

AniSub API; onaylı ve herkese açık anime altyazılarını arama, indirme, Stremio, Bazarr, mpv, web player, EXE ve APK istemcilerinde kullanma desteği sağlar.

Hızlı Başlangıç

Temel API adresi:

https://anisub.co/api/v1

Örnek arama:

GET https://anisub.co/api/v1/search?q=naruto&limit=25

API yalnızca approved durumundaki ve public görünürlüğündeki altyazıları döndürür.

Endpointler

Endpoint	Açıklama
`GET /api/v1/health`	API durumu ve kullanılabilir servis bağlantıları.
`GET /api/v1/stats`	Medya, altyazı ve indirme istatistikleri.
`GET /api/v1/search`	`q`, `anilist_id`, `imdb_id`, `language`, `format`, `type` parametreleriyle arama.
`GET /api/v1/media/{anilist_id}`	Anime bilgisi ve o animeye bağlı public altyazılar.
`GET /api/v1/subtitles/{id}`	Tek altyazı kaydının detayları.
`GET /api/v1/subtitles/{id}/download`	Arşiv dosyasını indirir veya dış depoya yönlendirir.
`GET /api/v1/subtitles/{id}/text`	ZIP/RAR içindeki ilk SRT/ASS/SSA/VTT altyazıyı metin olarak sunar.
`GET /api/v1/subtitles/{id}/file`	ZIP/RAR içindeki altyazıyı oynatıcılara dosya gibi, doğru içerik tipiyle verir.
`GET /api/v1/subtitles/{id}/file.vtt`	Stremio, web player ve mobil istemciler için ZIP içinden WebVTT çıktısı üretir.

İstemci Akışı

/search ile anime adı, IMDb ID veya AniList ID üzerinden altyazı ara.
Kullanıcıya release_name, format, fps ve content_type alanlarını göster.
Web, Android, Stremio veya HTML5 video için urls.file_vtt kullan.
mpv, VLC ve masaüstü EXE istemcisi için urls.file, arşiv indirme için urls.download kullan.

Entegrasyonlar

Hazır entegrasyon dosyaları proje içinde eklendi.

Stremio: /stremio-addon/manifest.json
Stremio oynatıcısında Anisub üzerinden otomatik Türkçe altyazı bulur (IMDb, AniList ve Kitsu ID'leri desteklenir).
Bazarr: /integrations/bazarr/anisub.py
Sonarr/Radarr sistemleriyle çalışan otomatik altyazı indirme aracına Anisub sağlayıcısını ekler.
mpv: /integrations/mpv/anisub.lua
Bilgisayarınızda mpv player ile anime izlerken Ctrl+S tuşuyla anında altyazı indirmenizi sağlar.
Python Toplu İndirici: /integrations/cli/anisub-cli.py
Bilgisayarınızdaki veya diskinizdeki bir klasörü tarayarak oradaki tüm animelerin altyazılarını topluca anında indirir.
Web Player: /oynatici
Sitenizin kendi içerisinde, paketlerden (zip/rar) doğru bölümü süzerek altyazı oynatabilen HTML5 oynatıcı.

Stremio Bazarr mpv Eklentisi Python Toplu İndirici Web Player

Örnek JSON Alanları

{
  "id": 2556,
  "release_name": "Fansub",
  "language": "Türkçe",
  "format": "ass",
  "fps": "23.976",
  "urls": {
    "download": "...",
    "text": "...",
    "vtt": "...",
    "file": "...",
    "file_vtt": "..."
  }
}