Alat Pengembang

API Video Sepak Bola Resmi

Mulai Cepat

  1. Dapatkan token akses Anda dari tab akses.
  2. Panggil salah satu endpoint API, misalnya:
    GET
  3. Uraikan respons JSON.
  4. Sisipkan HTML embed dari salah satu video dalam respons ke halaman Anda untuk menampilkan pemutar. Untuk aplikasi seluler, Anda dapat menampilkan video dalam webview dengan mengambil URL video dari kode sematan.

Token akses

Anda memerlukan token akses API untuk menggunakan API Video.

Setiap permintaan harus menyertakan token akses Anda sebagai parameter token dalam URL permintaan.

Anda dapat memperoleh token akses di tab akses.

Endpoint

Anda dapat mengambil kode sematan video dalam format JSON dari endpoint berikut:

Free Feed

GET

Endpoint Free Feed memberi Anda akses ke kumpulan sorotan pertandingan yang terbatas. Isinya mencakup liga tertentu dan pertandingan lama sebagai pratinjau API Video lengkap.

  • Hanya mencakup sebagian liga dan pertandingan, biasanya pertandingan lama atau sorotan tertentu.
  • Memberikan video resmi yang dapat disematkan dari sumber terverifikasi.
  • Ideal untuk pengujian.
  • Tidak mencakup semua kompetisi atau pembaruan langsung yang tersedia dalam paket berbayar.

Featured Feed

GET

Memberikan feed terkurasi dan relevan yang mencakup pertandingan terbaru serta penting dari liga dan kompetisi sepak bola teratas. Feed ini menyoroti pertandingan terpopuler dan paling menarik, tetapi tidak mencakup semua pertandingan. Untuk mengakses semua video liga atau tim tertentu, gunakan endpoint kompetisi atau tim.

  • Mencakup pilihan pertandingan terbaru dari berbagai liga.
  • Tidak mencakup semua pertandingan atau kompetisi — hanya yang paling relevan.
  • Tersedia pada semua paket berbayar.

Kompetisi

GET

Anda dapat mencari video kompetisi apa pun menggunakan endpoint Kompetisi. Endpoint ini memberikan video dari pertandingan terbaru dalam kompetisi yang dipilih.

Sebagai contoh, URL di bawah memberikan video dari pertandingan terbaru Premier League. Teks england-premier-league adalah pengenal unik (ID) Premier League.

Berikut ID beberapa kompetisi terpopuler:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Daftar ID semua kompetisi dapat ditemukan di sini.

Tim

GET

Anda dapat mencari video tim apa pun menggunakan endpoint Tim. Endpoint ini memberikan video dari pertandingan terbaru tim yang dipilih.

Sebagai contoh, URL di bawah memberikan video dari pertandingan terbaru Real Madrid. Teks real-madrid adalah pengenal unik (ID) Real Madrid.

Berikut ID beberapa tim terpopuler:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Daftar ID semua tim dapat ditemukan di sini.

Streaming Langsung

GET

Hanya memberikan pertandingan yang memiliki streaming langsung resmi — termasuk pertandingan yang sedang berlangsung maupun telah selesai. Entri mulai muncul sekitar 5 menit sebelum sepak mula.

  • Hanya menampilkan pertandingan dengan streaming resmi yang dapat disematkan.
  • Mencakup pertandingan yang sedang berlangsung dan baru berakhir, beserta tayangan ulang jika tersedia.
  • Item mulai muncul sekitar 5 menit sebelum jadwal sepak mula.

Endpoint yang Diperbarui

GET

Endpoint ini memungkinkan Anda mendeteksi feed kompetisi atau tim yang baru diperbarui, sehingga tidak perlu memeriksa setiap endpoint satu per satu.

Struktur Respons

Respons berupa objek JSON yang berisi kunci response dengan array objek pertandingan. Setiap pertandingan mencakup informasi dasar, detail kompetisi terkait, dan daftar video yang tersedia.

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": "..."}]},...]}

Kunci response berisi array objek pertandingan. Setiap objek mewakili satu pertandingan sepak bola dan mencakup bidang berikut:

  • titleNama pertandingan (misalnya Chelsea - Manchester United).
  • competitionNama kompetisi (misalnya England Premier League).
  • dateTanggal dan waktu sepak mula pertandingan.
  • thumbnailURL gambar thumbnail pertandingan.
  • videosArray semua video yang tersedia untuk pertandingan. Setiap objek video mencakup:
    • titleJudul video (misalnya Highlights atau Extended Highlights).
    • embedKode sematan HTML untuk video.
    • idPengenal unik video.
  • homeTeam / awayTeamObjek yang mewakili tim peserta pertandingan, termasuk:
    • nameNama lengkap tim (misalnya Chelsea).
    • slugSlug tim yang digunakan dalam URL (misalnya chelsea).
    • idPengenal unik tim.
  • matchviewUrlURL halaman widget tampilan pertandingan yang berisi informasi terperinci seperti skor langsung, statistik, dan klasemen.
  • competitionUrlURL widget kompetisi yang menampilkan klasemen langsung, hasil, dan jadwal pertandingan mendatang.

Putar Otomatis

Anda dapat mengaktifkan pemutaran otomatis dengan menambahkan parameter autoplay=1 ke URL video.

Contoh:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Jika menggunakan HTML embed secara langsung, Anda dapat menambahkan &autoplay=1 ke URL video dalam src iframe.

Kuota

Setiap paket memiliki batas permintaan bulanan.

  • Setiap penayangan video atau tampilan widget dihitung sebagai 1 permintaan.
  • Setiap panggilan ke API Video dihitung sebagai 5 permintaan dari kuota bulanan Anda.

Contoh:

  • Paket Starter mencakup 5.000 permintaan per bulan.
  • Paket Standard mencakup 20.000 permintaan per bulan.
  • Paket Advanced mencakup 100.000 permintaan per bulan.
  • Jika memerlukan batas yang lebih tinggi, hubungi kami untuk mengetahui paket Enterprise kami.

Jika Anda melampaui batas permintaan bulanan, akun akan otomatis beralih ke paket Gratis hingga periode penagihan berikutnya. Selama itu, iklan dan logo ScoreBat akan muncul pada widget dan video, serta hanya endpoint Free Feed yang dapat diakses.