Spor verisi, ücretsiz API dünyasında en yanıltıcı kategorilerden biridir. Sağlayıcıların tanıtım sayfaları geniş kapsam vaat eder — yüzlerce lig, canlı skorlar, detaylı istatistikler. Ücretsiz katmana kaydolduğunuzda tablo genellikle daha dardır: sınırlı sayıda lig, gecikmeli veri ve düşük istek kotası.
Türkiye'den geliştirenler için bu daralma özellikle can sıkıcıdır, çünkü ilgilendiğiniz lig çoğu zaman ücretsiz katmanın dışında kalır. Bu yazı beş kaynağı gerçek sınırlarıyla ele alıyor.
Hızlı karşılaştırma
| API | Kapsam | Kimlik doğrulama | Canlı veri | Güçlü olduğu yer |
|---|---|---|---|---|
| TheSportsDB | Çok sporlu, geniş | Test anahtarı / destekçi | Sınırlı | Takım ve görsel künyesi |
| Football-Data.org | Futbol, seçili ligler | Ücretsiz anahtar | Sınırlı | Temiz ve düzenli veri |
| API-FOOTBALL | Futbol, çok geniş | Ücretsiz anahtar, günlük kota | Var (plana bağlı) | Kapsam genişliği |
| OpenLigaDB | Almanya odaklı | Gerekmiyor | Var | Tamamen açık, kısıtsız |
| Ergast | Formula 1 tarihi | Gerekmiyor | Yok | Derin tarihsel arşiv |
Önce kendi ihtiyacınızı netleştirin
Spor API'si seçmeden önce cevaplanması gereken üç soru vardır ve bunlar seçimi neredeyse tek başına belirler.
Hangi lig? Kapsam, bu kategorideki tek gerçek ayırt edici özelliktir. Bir API ne kadar iyi tasarlanmış olursa olsun, ilgilendiğiniz ligi kapsamıyorsa işinize yaramaz. Süper Lig, alt ligler veya Türkiye Kupası ile ilgileniyorsanız bunu ilk adımda doğrulayın.
Canlı mı, sonuç mu? "Maç bitti, skor buydu" ile "şu an 67. dakika, skor 1-1" arasında büyük bir maliyet farkı vardır. Sonuç verisi ücretsiz katmanlarda genellikle bulunur; canlı akış neredeyse her zaman ücretlidir.
Ne kadar derin? Fikstür ve skor mu yeterli, yoksa oyuncu istatistikleri, dizilişler, kartlar ve pozisyon verisi de gerekiyor mu? Derinlik arttıkça ücretsiz seçenek sayısı hızla azalır.
Bu üç sorunun cevabı "Süper Lig, canlı, derin" ise ücretsiz bir çözüm beklemeyin. "Herhangi bir lig, sonuç, temel" ise seçenek boldur.
TheSportsDB — geniş ama yüzeysel
TheSportsDB, futbolun ötesine geçen ve çok sayıda sporu kapsayan topluluk destekli bir veritabanıdır. Basketbol, voleybol, motor sporları ve daha fazlası bulunur.
Güçlü olduğu yer künye ve görsel tarafıdır. Takım logoları, forma görselleri, stadyum bilgileri ve oyuncu künyeleri sunar. Bir uygulamanın görsel olarak dolu görünmesi için gereken malzemeyi tek kaynaktan alırsınız.
Türk takımları veritabanında bulunur ve bu, benzer servislerde her zaman geçerli değildir. Ancak künye ile canlı veri farklıdır: bir takımın logosunu ve kuruluş yılını bulmanız, o takımın maç verisinin güncel ve eksiksiz olduğu anlamına gelmez.
Topluluk katkısıyla büyüdüğü için veri kalitesi eşit dağılmaz. Popüler ligler dolu, niş ligler eksik olabilir. Kullanmadan önce ilgilendiğiniz lig için gerçekten veri dönüp dönmediğini test edin.
Dokümantasyonda paylaşılan test anahtarı geliştirme içindir; üretim kullanımı destekçi planına bağlıdır.
Football-Data.org — temiz veri, dar kapsam
Football-Data.org, futbol odaklıdır ve bu listedeki en düzenli veri yapısına sahiptir. Kayıt basittir, ücretsiz anahtar hemen alınır ve dokümantasyon anlaşılırdır.
Ücretsiz katmanın kapsamı belirli sayıda yarışmayla sınırlıdır. Bu sınırlama, servisin en önemli özelliğidir ve tanıtımdan çok kısıtlar sayfasında görünür. Hangi yarışmaların ücretsiz planda açık olduğunu kaydolmadan önce kontrol edin.
Veri kalitesi kapsadığı ligler için yüksektir. Fikstür, puan durumu, maç sonuçları ve takım bilgileri tutarlı bir yapıda gelir. Bir puan durumu tablosu veya fikstür ekranı kuruyorsanız ve kapsam size uyuyorsa, entegrasyonu en hızlı biten seçenek budur.
İstek kotası dakika bazındadır ve düşüktür. Sayfa yüklenirken paralel istek atan bir arayüz bu sınıra kolayca takılır. Verileri sunucu tarafında toplayıp cache'lemek burada zorunludur.
API-FOOTBALL — kapsam genişliği
API-FOOTBALL, futbol tarafında en geniş lig kapsamını sunan seçeneklerden biridir ve Türkiye ligleri de kapsama dahildir.
Sunduğu veri derinliği de fazladır: dizilişler, oyuncu istatistikleri, kartlar, goller ve maç olayları. Ciddi bir futbol uygulaması kuruyorsanız ihtiyacınız olan alanların çoğunu burada bulursunuz.
Ücretsiz katman günlük istek kotası şeklindedir. Bu kota tek kullanıcılı bir prototip için yeterli, çok kullanıcılı bir ürün için dardır. Kota hesabını erken yapın: her kullanıcı ziyaretinde kaç istek atacağınızı ve günde kaç ziyaret beklediğinizi çarpın. Sonuç genellikle kotanın kat kat üzerinde çıkar ve bu, mimarinizi değiştirmenizi gerektirir.
Doğru mimari şudur: kullanıcı isteğine bağlı olarak API'yi çağırmayın. Arka planda çalışan bir görevle veriyi periyodik olarak çekip kendi veritabanınıza yazın, kullanıcılara kendi veritabanınızdan servis edin. Bin kullanıcı aynı maçın skorunu görüyorsa bu, bin istek değil bir istek olmalıdır.
OpenLigaDB — kısıtsız ama yerel
OpenLigaDB, Almanya futbol ligleri odaklı, tamamen açık bir projedir. Anahtar istemez, kota uygulamaz.
Türkiye'den bir geliştirici için doğrudan kullanım değeri sınırlıdır — Türk liglerini kapsamaz. Yine de iki nedenle listede yer alıyor.
Birincisi, kısıtsız olması onu öğrenme ve prototip için ideal kılar. Bir spor uygulamasının arayüzünü ve veri modelini kota kaygısı olmadan geliştirebilir, sonra gerçek veri kaynağınıza geçebilirsiniz.
İkincisi, açık veri modelinin nasıl görünmesi gerektiğine dair iyi bir örnektir. Ticari sağlayıcıların kapalı tuttuğu yapıyı burada açıkça görebilirsiniz.
Ergast — Formula 1'in tarihsel arşivi
Ergast, Formula 1 verisi için uzun süredir kullanılan bir kaynaktır ve derinliği dikkat çekicidir: yarış sonuçları, sıralama turları, pit stoplar, tur zamanları ve şampiyona tabloları on yıllar geriye gider.
Veri analizi projeleri için nadir bulunan bir kaynaktır. Tarihsel karşılaştırmalar, pilot kariyeri analizleri veya takım performans grafikleri için elinizde tutarlı ve uzun bir seri olur.
Bu servisin sürdürülme durumu zaman içinde değişebilir; güncel sezon verisi için kullanmayı planlıyorsanız, projeyi kurmadan önce verinin hâlâ güncellenip güncellenmediğini doğrulayın. Tarihsel analiz için değeri her hâlükârda korunur.
Cache ve güncelleme stratejisi
Spor verisinde tek bir cache politikası uygulamak en sık yapılan hatadır, çünkü bu kategoride veri türleri çok farklı hızlarda değişir.
Neredeyse hiç değişmeyenler: takım künyeleri, logolar, stadyum bilgileri, geçmiş sezon sonuçları. Bunları günlerce, hatta haftalarca saklayabilirsiniz.
Yavaş değişenler: fikstür, puan durumu, oyuncu kadroları. Günlük güncelleme çoğu uygulama için yeterlidir.
Hızlı değişenler: maç günü skorlar, dakikalar, kartlar. Yalnızca maç sürerken sık güncelleme gerekir.
Buradaki anahtar fikir, güncelleme sıklığını maç takvimine bağlamaktır. Maç yokken dakikada bir istek atmanın hiçbir anlamı yoktur ve kotanızın büyük kısmını buraya harcarsınız. Fikstürü bilerek, yalnızca maç saatlerinde sık güncelleme yapan bir zamanlayıcı kurmak, aynı kotayla kat kat daha iyi bir deneyim üretir.
Veri modeli notları
Spor verisiyle çalışırken kaynak değiştirme ihtimalini baştan varsayın. Ücretsiz katmanlar politika değiştirir, kapsam daralır, servisler kapanır.
Bunun için kendi veri modelinizi sağlayıcının yanıt yapısından bağımsız kurun. Takım, yarışma, sezon, maç ve olay kavramlarını kendi şemanızda tanımlayın; sağlayıcı yanıtını bu şemaya dönüştüren bir katman yazın. Sağlayıcı değiştiğinde yalnızca o katmanı değiştirirsiniz.
Kimlik eşleme burada da sorun olur. Her sağlayıcının kendi takım ve maç kimlikleri vardır ve aralarında ortak anahtar yoktur. Birden fazla kaynak kullanacaksanız kendi kimlik tablonuzu tutun ve takım adına göre eşleme yapmaktan kaçının — "Fenerbahçe", "Fenerbahce SK" ve "Fenerbahçe Spor Kulübü" farklı kaynaklarda farklı yazılır.
Lisans, görseller ve yasal sınırlar
Bu kategoride üç ayrı hukuki katman vardır ve üçünü ayrı ayrı düşünmek gerekir.
API kullanım koşulları. Sağlayıcının ücretsiz katmanında ticari kullanıma izin veriliyor mu, kaynak belirtme zorunlu mu?
Görsel hakları. Kulüp armaları ve oyuncu fotoğrafları ayrı fikri mülkiyet haklarına tabidir. Bir API'nin görsel bağlantısı sunması, o görseli ticari üründe kullanma hakkı vermez.
Faaliyet sınırları. Türkiye'de şans oyunları ve bahis faaliyeti yasal düzenlemeye tabidir ve yetkisiz faaliyet suç teşkil eder. Spor verisine teknik olarak erişebilmek, bu veriyle bahis odaklı bir ürün kurabileceğiniz anlamına gelmez. Sağlayıcıların kullanım koşulları da çoğu zaman bu tür kullanımı ayrıca kısıtlar.
Bu yazıdaki kapsam, kota ve koşul bilgileri yayın tarihindeki resmi dokümantasyona dayanır. Ücretsiz katman kapsamları bu kategoride sık değiştiği için, plan seçmeden önce sağlayıcının güncel sayfasını doğrulayın.
İlgili API Deposu kayıtları
Kaynaklar
Sık Sorulan Sorular
›Süper Lig verisi hangi API'de ücretsiz bulunur?
Ücretsiz katmanların lig kapsamı sağlayıcıya göre belirgin biçimde değişir ve birçok servis ücretsiz planda yalnızca sınırlı sayıda Avrupa ligini açar. Süper Lig'e ihtiyacınız varsa, plan seçmeden önce sağlayıcının kapsanan ligler listesini kontrol edin; genel kapsam iddiaları ücretsiz katmanı yansıtmayabilir.
›Canlı skor için ücretsiz bir seçenek var mı?
Canlı veri, ücretsiz katmanların en sık kısıtladığı özelliktir. Sınırlı bir gecikmeyle güncellenen sonuçlar bulunabilir ancak saniye seviyesinde canlı akış genellikle ücretli planlara aittir.
›Bu API'lerle bahis uygulaması yapabilir miyim?
Türkiye'de şans oyunları ve bahis faaliyeti yasal düzenlemeye tabidir ve yetkisiz faaliyet suç teşkil eder. Veri erişiminin teknik olarak mümkün olması, bu tür bir ürünün yasal olduğu anlamına gelmez. Sağlayıcıların kullanım koşulları da çoğu zaman bahis amaçlı kullanımı ayrıca kısıtlar.
›Takım logolarını ve oyuncu fotoğraflarını kullanabilir miyim?
Kulüp armaları ve oyuncu görselleri ayrı fikri mülkiyet haklarına tabidir. Bir API'nin görsel bağlantısı vermesi, o görseli ticari üründe kullanma hakkı verdiği anlamına gelmez.
›Maç verisi ne sıklıkla güncellenmeli?
Fikstür ve takım bilgisi günlerce sabit kalır, uzun süreli cache'lenebilir. Maç günü skor ve dakika verisi ise sık değişir. İkisini aynı cache politikasıyla yönetmek ya bayat skor ya da gereksiz istek üretir.