ScoreBat
Geliştirici Araçları

Resmî Futbol Video API'si

Hızlı Başlangıç

  1. Erişim token'ınızı erişim sekmesinden alın.
  2. API endpoint'lerinden birini çağırın. Örneğin:
    GET
  3. JSON yanıtını ayrıştırın.
  4. Oynatıcıyı göstermek için yanıttaki videolardan birinin embed HTML kodunu sayfanıza ekleyin. Mobil uygulamalarda video URL'sini gömme kodundan çıkararak videoyu bir webview içinde gösterebilirsiniz.

Erişim token'ı

Video API'yi kullanmak için bir API erişim token'ına ihtiyacınız vardır.

Her istekte, erişim token'ınız istek URL'sine token parametresi olarak eklenmelidir.

Erişim token'ınızı erişim sekmesinden alabilirsiniz.

Endpoint'ler

Videoların gömme kodlarını aşağıdaki endpoint'lerden JSON biçiminde alabilirsiniz:

Free Feed

GET

Free Feed endpoint'i, sınırlı sayıdaki maç özetine erişim sağlar. Seçili ligleri ve daha eski karşılaşmaları içererek tam Video API için bir önizleme sunar.

  • Yalnızca belirli lig ve maçları içerir; genellikle daha eski karşılaşmalar veya seçili özetler sunulur.
  • Doğrulanmış kaynaklardan gelen, resmî ve gömülebilir videolar döndürür.
  • Test için idealdir.
  • Ücretli planlarda sunulan tüm organizasyonları veya canlı güncellemeleri içermez.

Featured Feed

GET

En iyi futbol ligleri ve organizasyonlarındaki hem yakın tarihli hem de önemli maçlardan oluşan, özenle seçilmiş ve ilgili bir akış döndürür. En popüler ve dikkat çekici karşılaşmaları öne çıkarır ancak her maçı içermez. Belirli bir lig veya takıma ait tüm videolara erişmek için organizasyon ya da takım endpoint'lerini kullanın.

  • Farklı liglerden yakın tarihli maçların bir bölümünü içerir.
  • Tüm maçları veya organizasyonları içermez; yalnızca en ilgili olanları sunar.
  • Tüm ücretli planlarda kullanılabilir.

Organizasyon

GET

Herhangi bir organizasyona ait videoları Organizasyon endpoint'iyle sorgulayabilirsiniz. Bu endpoint, belirtilen organizasyonun en son maçlarına ait videoları döndürür.

Örneğin aşağıdaki URL, Premier League kapsamındaki en son maçların videolarını döndürür. england-premier-league ifadesi, Premier League için benzersiz tanımlayıcıdır (ID).

En popüler organizasyonlardan bazılarının ID'leri:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Tüm organizasyonların ID listesini burada bulabilirsiniz.

Takım

GET

Herhangi bir takıma ait videoları Takım endpoint'iyle sorgulayabilirsiniz. Bu endpoint, belirtilen takımın en son maçlarına ait videoları döndürür.

Örneğin aşağıdaki URL, Real Madrid için en son maçların videolarını döndürür. real-madrid ifadesi, Real Madrid için benzersiz tanımlayıcıdır (ID).

En popüler takımlardan bazılarının ID'leri:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Tüm takımların ID listesini burada bulabilirsiniz.

Canlı Yayınlar

GET

Yalnızca resmî canlı yayını bulunan maçları döndürür; devam eden ve tamamlanmış karşılaşmalar buna dâhildir. Kayıtlar başlama saatinden yaklaşık 5 dakika önce görünür.

  • Yalnızca resmî ve gömülebilir yayını bulunan maçları gösterir.
  • Canlı ve kısa süre önce sona eren maçları içerir; mevcut olduğunda yayın tekrarları da sunulur.
  • Öğeler, planlanan başlama saatinden yaklaşık 5 dakika önce görünmeye başlar.

Güncellenen Endpoint'ler

GET

Bu endpoint, hangi organizasyon veya takım akışlarının yakın zamanda güncellendiğini belirlemenizi sağlar; böylece her endpoint'i ayrı ayrı düzenli olarak sorgulamanız gerekmez.

Yanıt Yapısı

Yanıt, maç nesnelerinden oluşan bir dizi içeren response anahtarına sahip bir JSON nesnesidir. Her maç temel bilgileri, ilgili organizasyon ayrıntılarını ve mevcut videoların listesini içerir.

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

response anahtarı, maç nesnelerinden oluşan bir dizi içerir. Her nesne bir futbol maçını temsil eder ve şu alanları içerir:

  • title – Maçın adı (ör. Chelsea - Manchester United).
  • competition – Organizasyonun adı (ör. England Premier League).
  • date – Maçın başlama tarihi ve saati.
  • thumbnail – Maçın küçük resim URL'si.
  • videos – Maç için mevcut tüm videolardan oluşan bir dizi. Her video nesnesi şunları içerir:
    • title – Videonun başlığı (ör. Highlights veya Extended Highlights).
    • embed – Videonun HTML gömme kodu.
    • id – Videonun benzersiz tanımlayıcısı.
  • homeTeam / awayTeam – Maça katılan takımları temsil eden nesneler. Şunları içerir:
    • name – Takımın tam adı (ör. Chelsea).
    • slug – URL'lerde kullanılan takım slug'ı (ör. chelsea).
    • id – Takımın benzersiz tanımlayıcısı.
  • matchviewUrl – Canlı skorlar, istatistikler ve puan durumları gibi ayrıntılı bilgiler içeren maç görünümü widget sayfasının URL'si.
  • competitionUrl – Canlı puan durumlarını, sonuçları ve yaklaşan fikstürü gösteren organizasyon widget'ının URL'si.

Otomatik Oynatma

Video URL'sine autoplay=1 parametresini ekleyerek otomatik oynatmayı etkinleştirebilirsiniz.

Örneğin:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1embed HTML kodunu doğrudan kullanıyorsanız iframe içindeki src video URL'sinin sonuna &autoplay=1 ekleyebilirsiniz.

Kota

Her plan aylık bir istek limiti içerir.

  • Her video görüntüleme veya widget gösterimi 1 istek olarak sayılır.
  • Video API için yapılan her çağrı, aylık kotanızdan 5 istek olarak sayılır.

Örneğin:

  • Starter planı ayda 5.000 istek içerir.
  • Standard planı ayda 20.000 istek içerir.
  • Advanced planı ayda 100.000 istek içerir.
  • Daha yüksek bir limite ihtiyacınız varsa Enterprise planlarımız için bizimle iletişime geçin.

Aylık istek limitinizi aşarsanız hesabınız bir sonraki faturalandırma dönemine kadar otomatik olarak Ücretsiz plana geçer. Bu süre boyunca widget'larda ve videolarda reklamlarla ScoreBat logoları gösterilir ve yalnızca Free Feed endpoint'ine erişilebilir.