Ücretsiz Film ve Dizi API'leri

Film ve dizi verisi isteyen projelerin çoğu aynı üç kaynağa gelir: TMDB, OMDb ve TVmaze. Üçü de ücretsiz bir kullanım imkânı sunar, ancak farklı işler için tasarlanmışlardır. Yanlış olanı seçmek, projenin ilerleyen aşamasında poster bulamamak, Türkçe başlık gösterememek veya bölüm takvimini elle doldurmak gibi sorunlara dönüşür.

Bu yazıda üç API'yi Türkiye'den geliştirenlerin gerçekten önemsediği başlıklarla karşılaştırıyoruz: Türkçe içerik kapsamı, görsel kalitesi, yayın platformu bilgisi, kota ve lisans sınırları.

Hızlı karşılaştırma

TMDB — keşif ve görsel tarafının varsayılanı

TMDB, film ve dizi keşfi yapan uygulamaların büyük çoğunluğunun ana kaynağıdır. Bunun iki nedeni var: görsel arşivi ve keşif uç noktaları.

discover ve trending uç noktaları, "şu an popüler olanlar", "belirli türde ve yıl aralığında olanlar", "belirli bir oyuncunun filmleri" gibi sorguları tek istekte çözer. Kendi öneri mantığınızı sıfırdan kurmak yerine bu uç noktaların filtrelerini kullanmak, prototip aşamasında ciddi zaman kazandırır.

Türkiye'den geliştirenler için asıl fark yaratan nokta dil desteğidir. İsteklere language=tr-TR eklediğinizde TMDB, Türkçe başlık ve özet döndürür. Ancak bu veri topluluk katkısıyla oluşur; popüler yapımlarda genellikle doludur, niş veya eski yapımlarda boş gelebilir. Bu yüzden arayüzde Türkçe özet boş geldiğinde İngilizce alana geri düşen bir mantık kurmak gerekir. Boş bir açıklama kutusu göstermek, İngilizce göstermekten daha kötü bir deneyimdir.

Görsel tarafında TMDB sadece poster URL'si vermez; farklı boyutlarda poster, arka plan görseli ve logo sunar. Görsel yolları göreli gelir ve yapılandırma uç noktasından alınan temel URL ile birleştirilir. Bu yapı ilk bakışta fazladan iş gibi görünse de, boyut seçimini size bırakması nedeniyle mobil ve masaüstü için ayrı optimizasyon yapmanızı sağlar.

TMDB'nin az bilinen ama Türkiye pazarı için değerli uç noktası watch/providers'tır. Bir yapımın hangi ülkede hangi platformda yayınlandığını döndürür ve TR desteklenir. "Bu filmi nerede izleyebilirim?" sorusunu cevaplayan bir ekran kuruyorsanız bu veri işinizi görür. Veri JustWatch kaynaklıdır ve TMDB kullanım koşulları bu bilgiyi gösterirken kaynağı belirtmenizi şart koşar.

OMDb — basit ve tekil sorgular için

OMDb, IMDb tarzı künye verisini tek bir uç noktadan sunan topluluk projesidir. IMDb'nin resmi API'si değildir; IMDb herkese açık bir API sunmaz. Bu ayrım önemlidir, çünkü OMDb'nin sürekliliği ve kapsamı resmi bir kurumun garantisi altında değildir.

OMDb'nin güçlü olduğu senaryo dardır ama net: elinizde bir IMDb ID'si veya bir başlık var ve tek bir yapımın künyesini istiyorsunuz. Yönetmen, oyuncular, süre, tür, IMDb puanı ve Rotten Tomatoes puanı tek istekte gelir. Bir kişisel film listesi uygulaması veya bir Discord botu için bu genellikle yeterlidir.

Ücretsiz anahtar günlük 1.000 istekle sınırlıdır. Bu, sunucu tarafında agresif cache kullanmadığınız sürece küçük bir kullanıcı kitlesinde bile hızla tükenebilecek bir rakamdır. Aynı yapımın künyesi sık değişmediği için IMDb ID bazında uzun süreli cache kurmak burada tercih değil, zorunluluktur.

Türkçe içerik açısından OMDb'den beklenti kurmayın. Veri İngilizce gelir ve dil parametresi yoktur. Türkçe arayüzlü bir uygulama yapıyorsanız OMDb'yi künye kaynağı olarak kullanıp, Türkçe başlık ve özeti TMDB'den almak yaygın bir birleşimdir.

TVmaze — dizi ve yayın takviminin uzmanı

TVmaze, listedeki tek tamamen anahtarsız seçenektir. Kayıt olmadan, anahtar üretmeden doğrudan istek atabilirsiniz. Prototip ve öğrenme projeleri için bu tek başına güçlü bir tercih sebebidir.

TVmaze'in odağı televizyondur. Dizi araması, sezon ve bölüm listeleri, oyuncu kadrosu ve en önemlisi yayın takvimi uç noktaları vardır. "Bugün hangi diziler yayınlanıyor" veya "bu dizinin bir sonraki bölümü ne zaman" sorularını doğrudan cevaplar. Bu veriyi TMDB'den kurmak mümkündür ama TVmaze'de hazır gelir.

Sınırı da odağıdır: film tarafı zayıftır. Sinema filmlerini kapsayan bir uygulama yapıyorsanız TVmaze tek başına yetmez. Türkçe içerik desteği de yoktur; başlıklar ve özetler İngilizcedir. Türk dizilerinin bir kısmı veritabanında bulunur, ancak künye derinliği yabancı yapımlardaki kadar değildir.

Anahtar gerektirmemesi, istediğiniz kadar istek atabileceğiniz anlamına gelmez. TVmaze dokümantasyonu IP başına oran sınırı uygulandığını belirtir; toplu veri çekme işlerinde istekler arasına gecikme koymak ve yanıt başlıklarını izlemek gerekir.

Hangi durumda hangisi?

Karar genellikle projenin merkezindeki soruya göre verilir.

Uygulamanız keşif odaklıysa — kullanıcı ne izleyeceğini bilmiyor ve siz öneriyorsanız — TMDB ile başlayın. Poster kalitesi, trend uç noktaları ve Türkçe başlık desteği bu senaryoda rakipsizdir.

Uygulamanız bir liste veya arşiv yönetiyorsa — kullanıcı zaten ne aradığını biliyor, siz künyeyi dolduruyorsanız — OMDb'nin basitliği yeterli olabilir. Yine de günlük 1.000 istek sınırını baştan hesaba katın.

Uygulamanız dizi takibi yapıyorsa — bölüm çıktı mı, ne zaman çıkacak — TVmaze en kısa yoldur. Anahtar yönetimi olmadan başlayıp, poster kalitesi yetmediğinde TMDB'yi görsel kaynağı olarak ekleyebilirsiniz.

Üçünü birden kullanmak da yaygındır ve mantıksız değildir. Yaygın birleşim şudur: TMDB'den keşif ve görsel, TVmaze'den bölüm takvimi, OMDb'den IMDb puanı. Bu durumda veri modelinizde her alanın hangi kaynaktan geldiğini saklayın; bir kaynak değiştiğinde veya kotası dolduğunda hangi ekranların etkileneceğini bilmek istersiniz.

Kimlik eşleme sorunu

Birden fazla kaynak kullanacaksanız çözmeniz gereken asıl problem kimlik eşlemedir. TMDB'nin kendi ID'si, IMDb'nin ID'si ve TVmaze'in ID'si farklıdır. Aynı diziyi üç sistemde eşleştirmek gerekir.

İyi haber şu: TMDB'nin external_ids uç noktası bir yapımın IMDb ve TVDB kimliklerini döndürür. TVmaze de arama sonuçlarında IMDb ve TVDB kimliklerini paylaşır. Yani IMDb ID'sini ortak anahtar olarak kullanmak pratikte çalışan bir stratejidir.

Başlık üzerinden eşleme yapmaktan kaçının. Türkçe başlık, orijinal başlık ve yerelleştirilmiş başlık farklı olabilir; aynı isimde birden fazla yapım bulunabilir. Başlık eşlemesi prototipte çalışır, üretimde sessizce yanlış veri üretir.

Cache ve kota yönetimi

Film ve dizi künyesi nadiren değişir. Bu, cache için ideal bir veri türüdür. Yapım künyesini günlerce, hatta haftalarca saklayabilirsiniz. Buna karşılık trend listeleri ve yayın takvimi daha kısa ömürlüdür; birkaç saatlik cache uygundur.

Poster görsellerini kendi sunucunuza kopyalamadan önce lisans koşullarını okuyun. TMDB görselleri belirli koşullarla kullanılabilir ve kaynak belirtme yükümlülüğü vardır. Görselleri doğrudan sağlayıcının CDN'inden servis etmek hem lisans açısından daha güvenli hem de bant genişliği açısından daha ucuzdur.

Lisans ve ticari kullanım

Üç kaynağın da kullanım koşulları farklıdır ve ticari bir ürün kuruyorsanız bunları okumak gerekir. TMDB ticari kullanıma izin verir ancak logo ve kaynak belirtme kurallarına uymayı, belirli hacimlerin üzerinde ayrı anlaşma yapmayı gerektirebilir. OMDb'nin ücretsiz katmanı kişisel kullanım içindir; ticari kullanım için ücretli plana geçilmesi beklenir. TVmaze verisi lisans altında sunulur ve kaynak belirtme talep edilir.

Bu yazıdaki kota ve koşul bilgileri yayın tarihindeki resmi dokümantasyona dayanır. Sağlayıcılar limitlerini zaman zaman güncellediği için, üretime almadan önce güncel dokümanı doğrulamanız önerilir.

İlgili API Deposu kayıtları

• TMDB
• OMDb
• TVmaze

Kaynaklar

• https://developer.themoviedb.org/docs/getting-started
• https://www.omdbapi.com/
• https://www.tvmaze.com/api