ScoreBat
Εργαλεία προγραμματιστών

Επίσημο API ποδοσφαιρικών βίντεο

Γρήγορη εκκίνηση

  1. Αποκτήστε το token πρόσβασης από την καρτέλα πρόσβασης.
  2. Καλέστε ένα από τα API endpoints, για παράδειγμα:
    GET
  3. Αναλύστε την απόκριση JSON.
  4. Εισαγάγετε στη σελίδα σας το HTML του embed για ένα από τα βίντεο της απόκρισης, ώστε να εμφανιστεί το πρόγραμμα αναπαραγωγής. Σε εφαρμογές για κινητά, μπορείτε να εμφανίσετε το βίντεο σε webview, εξάγοντας τη διεύθυνση URL του βίντεο από τον κώδικα ενσωμάτωσης.

Token πρόσβασης

Χρειάζεστε token πρόσβασης API για να χρησιμοποιήσετε το Video API.

Κάθε αίτημα πρέπει να περιλαμβάνει το token πρόσβασής σας ως παράμετρο token στη διεύθυνση URL του αιτήματος.

Μπορείτε να αποκτήσετε το token πρόσβασης από την καρτέλα πρόσβασης.

Endpoints

Μπορείτε να ανακτήσετε σε μορφή JSON τον κώδικα ενσωμάτωσης των βίντεο από τα ακόλουθα endpoints:

Free Feed

GET

Το endpoint Free Feed παρέχει πρόσβαση σε ένα περιορισμένο σύνολο στιγμιότυπων αγώνων. Περιλαμβάνει επιλεγμένες λίγκες και παλαιότερους αγώνες, προσφέροντας μια προεπισκόπηση του πλήρους Video API.

  • Περιλαμβάνει μόνο ένα μέρος των λιγκών και των αγώνων, συχνά με παλαιότερα παιχνίδια ή επιλεγμένα στιγμιότυπα.
  • Επιστρέφει επίσημα βίντεο από επαληθευμένες πηγές, έτοιμα για ενσωμάτωση.
  • Ιδανικό για δοκιμές.
  • Δεν περιλαμβάνει όλες τις διοργανώσεις ή τις ζωντανές ενημερώσεις που διατίθενται στα προγράμματα επί πληρωμή.

Featured Feed

GET

Επιστρέφει μια επιμελημένη και σχετική ροή που περιλαμβάνει πρόσφατους και σημαντικούς αγώνες από κορυφαίες ποδοσφαιρικές λίγκες και διοργανώσεις. Η ροή προβάλλει τα πιο δημοφιλή και αξιοσημείωτα παιχνίδια, αλλά δεν περιλαμβάνει κάθε αγώνα. Για πρόσβαση σε όλα τα βίντεο συγκεκριμένης λίγκας ή ομάδας, χρησιμοποιήστε τα endpoints διοργάνωσης ή ομάδας.

  • Περιλαμβάνει μια επιλογή πρόσφατων αγώνων από διάφορες λίγκες.
  • Δεν περιλαμβάνει όλους τους αγώνες ή τις διοργανώσεις — μόνο τα πιο σημαντικά.
  • Διατίθεται σε όλα τα προγράμματα επί πληρωμή.

Διοργάνωση

GET

Μπορείτε να αναζητήσετε βίντεο για οποιαδήποτε διοργάνωση μέσω του endpoint Διοργάνωση. Αυτό το endpoint επιστρέφει βίντεο από τους πιο πρόσφατους αγώνες της επιλεγμένης διοργάνωσης.

Για παράδειγμα, η παρακάτω διεύθυνση URL επιστρέφει βίντεο από τους πιο πρόσφατους αγώνες: Premier League. Η συμβολοσειρά england-premier-league είναι το μοναδικό αναγνωριστικό (ID) για Premier League.

Ακολουθούν τα ID ορισμένων από τις δημοφιλέστερες διοργανώσεις:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Μπορείτε να βρείτε τη λίστα με τα ID όλων των διοργανώσεων εδώ.

Ομάδα

GET

Μπορείτε να αναζητήσετε βίντεο για οποιαδήποτε ομάδα μέσω του endpoint Ομάδα. Αυτό το endpoint επιστρέφει βίντεο από τους πιο πρόσφατους αγώνες της επιλεγμένης ομάδας.

Για παράδειγμα, η παρακάτω διεύθυνση URL επιστρέφει βίντεο από τους πιο πρόσφατους αγώνες: Real Madrid. Η συμβολοσειρά real-madrid είναι το μοναδικό αναγνωριστικό (ID) για Real Madrid.

Ακολουθούν τα ID ορισμένων από τις δημοφιλέστερες ομάδες:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Μπορείτε να βρείτε τη λίστα με τα ID όλων των ομάδων εδώ.

Ζωντανές μεταδόσεις

GET

Επιστρέφει μόνο αγώνες με διαθέσιμες επίσημες ζωντανές μεταδόσεις — τόσο αγώνες σε εξέλιξη όσο και ήδη ολοκληρωμένους. Οι καταχωρίσεις εμφανίζονται περίπου 5 λεπτά πριν από τη σέντρα.

  • Εμφανίζει μόνο αγώνες με επίσημες μεταδόσεις που μπορούν να ενσωματωθούν.
  • Περιλαμβάνει αγώνες σε εξέλιξη και αγώνες που ολοκληρώθηκαν πρόσφατα, με επανάληψη της μετάδοσης όπου είναι διαθέσιμη.
  • Τα στοιχεία αρχίζουν να εμφανίζονται περίπου 5 λεπτά πριν από την προγραμματισμένη σέντρα.

Ενημερωμένα endpoints

GET

Αυτό το endpoint σάς επιτρέπει να εντοπίζετε ποιες ροές διοργανώσεων ή ομάδων ενημερώθηκαν πρόσφατα, χωρίς να χρειάζεται να ελέγχετε συνεχώς κάθε endpoint ξεχωριστά.

Δομή απόκρισης

Η απόκριση είναι ένα αντικείμενο JSON που περιέχει ένα κλειδί response με έναν πίνακα αντικειμένων αγώνων. Κάθε αγώνας περιλαμβάνει βασικές πληροφορίες, στοιχεία της σχετικής διοργάνωσης και μια λίστα διαθέσιμων βίντεο.

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 περιέχει έναν πίνακα αντικειμένων αγώνων. Κάθε αντικείμενο αντιπροσωπεύει έναν ποδοσφαιρικό αγώνα και περιλαμβάνει τα ακόλουθα πεδία:

  • title – Η ονομασία του αγώνα (π.χ. Chelsea - Manchester United).
  • competition – Η ονομασία της διοργάνωσης (π.χ. England Premier League).
  • date – Η ημερομηνία και η ώρα έναρξης του αγώνα.
  • thumbnail – Η διεύθυνση URL μιας μικρογραφίας για τον αγώνα.
  • videos – Ένας πίνακας με όλα τα διαθέσιμα βίντεο του αγώνα. Κάθε αντικείμενο βίντεο περιλαμβάνει:
    • title – Τον τίτλο του βίντεο (π.χ. Highlights ή Extended Highlights).
    • embed – Τον κώδικα HTML ενσωμάτωσης του βίντεο.
    • id – Το μοναδικό αναγνωριστικό του βίντεο.
  • homeTeam / awayTeam – Αντικείμενα που αντιπροσωπεύουν τις ομάδες του αγώνα και περιλαμβάνουν:
    • name – Το πλήρες όνομα της ομάδας (π.χ. Chelsea).
    • slug – Το slug της ομάδας που χρησιμοποιείται στις διευθύνσεις URL (π.χ. chelsea).
    • id – Το μοναδικό αναγνωριστικό της ομάδας.
  • matchviewUrl – Τη διεύθυνση URL της σελίδας του γουίτζετ προβολής αγώνα, με αναλυτικές πληροφορίες όπως ζωντανό σκορ, στατιστικά και βαθμολογία.
  • competitionUrl – Τη διεύθυνση URL του γουίτζετ διοργάνωσης, με ζωντανή βαθμολογία, αποτελέσματα και προσεχείς αγώνες.

Αυτόματη αναπαραγωγή

Μπορείτε να ενεργοποιήσετε την αυτόματη αναπαραγωγή προσθέτοντας την παράμετρο autoplay=1 στη διεύθυνση URL του βίντεο.

Για παράδειγμα:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Αν χρησιμοποιείτε απευθείας το HTML του embed, μπορείτε να προσθέσετε το &autoplay=1 στη διεύθυνση URL του βίντεο μέσα στο src του iframe.

Όριο χρήσης

Κάθε πρόγραμμα περιλαμβάνει μηνιαίο όριο αιτημάτων.

  • Κάθε προβολή βίντεο ή εμφάνιση γουίτζετ υπολογίζεται ως 1 αίτημα.
  • Κάθε κλήση στο Video API υπολογίζεται ως 5 αιτήματα στο μηνιαίο όριό σας.

Για παράδειγμα:

  • Το πρόγραμμα Starter περιλαμβάνει 5.000 αιτήματα τον μήνα.
  • Το πρόγραμμα Standard περιλαμβάνει 20.000 αιτήματα τον μήνα.
  • Το πρόγραμμα Advanced περιλαμβάνει 100.000 αιτήματα τον μήνα.
  • Αν χρειάζεστε υψηλότερο όριο, επικοινωνήστε μαζί μας για τα προγράμματα Enterprise.

Αν υπερβείτε το μηνιαίο όριο αιτημάτων, ο λογαριασμός σας θα μεταβεί αυτόματα στο δωρεάν πρόγραμμα μέχρι την επόμενη περίοδο χρέωσης. Στο μεταξύ, θα εμφανίζονται διαφημίσεις και λογότυπα ScoreBat στα γουίτζετ και τα βίντεο, ενώ θα παραμένει διαθέσιμο μόνο το endpoint Free Feed.