ScoreBat
Entwicklertools

Offizielle Fußball-Video-API

Schnellstart

  1. Rufe dein Zugangs-Token im Zugangs-Tab ab.
  2. Rufe einen der API-Endpunkte auf, zum Beispiel:
    GET
  3. Verarbeite die JSON-Antwort.
  4. Füge den embed-HTML-Code eines Videos aus der Antwort in deine Seite ein, um den Player anzuzeigen. In mobilen Apps kannst du das Video in einer WebView anzeigen, indem du die Video-URL aus dem Einbettungscode extrahierst.

Zugangs-Token

Du benötigst ein API-Zugangs-Token, um die Video-API zu verwenden.

Jede Anfrage muss dein Zugangs-Token als Parameter token in der Anfrage-URL enthalten.

Du erhältst dein Zugangs-Token im Zugangs-Tab.

Endpunkte

Über die folgenden Endpunkte kannst du die Einbettungscodes der Videos im JSON-Format abrufen:

Free Feed

GET

Der Endpunkt Free Feed bietet Zugriff auf eine begrenzte Auswahl an Spiel-Highlights. Er enthält ausgewählte Ligen und ältere Spiele und gibt damit einen Einblick in die vollständige Video-API.

  • Enthält nur einen Teil der Ligen und Spiele, häufig ältere Partien oder ausgewählte Highlights.
  • Liefert offizielle, einbettbare Videos aus verifizierten Quellen.
  • Ideal zum Testen.
  • Enthält nicht alle Wettbewerbe oder Live-Updates der kostenpflichtigen Tarife.

Featured Feed

GET

Liefert einen kuratierten, relevanten Feed mit aktuellen und wichtigen Spielen aus den führenden Fußballligen und -wettbewerben. Der Feed hebt die beliebtesten und bemerkenswertesten Partien hervor, enthält aber nicht jedes Spiel. Nutze die Endpunkte für Wettbewerbe oder Teams, um alle Videos einer bestimmten Liga oder eines bestimmten Teams abzurufen.

  • Enthält eine Auswahl aktueller Spiele aus verschiedenen Ligen.
  • Enthält nicht alle Spiele oder Wettbewerbe, sondern nur die relevantesten.
  • In allen kostenpflichtigen Tarifen verfügbar.

Wettbewerb

GET

Über den Endpunkt Wettbewerb kannst du Videos für jeden Wettbewerb abfragen. Dieser Endpunkt liefert Videos zu den neuesten Spielen des angegebenen Wettbewerbs.

Die folgende URL liefert beispielsweise Videos zu den neuesten Spielen der Premier League. Die Zeichenfolge england-premier-league ist die eindeutige Kennung (ID) der Premier League.

Hier sind die IDs einiger der beliebtesten Wettbewerbe:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Eine Liste der IDs aller Wettbewerbe findest du hier.

Team

GET

Über den Endpunkt Team kannst du Videos für jedes Team abfragen. Dieser Endpunkt liefert Videos zu den neuesten Spielen des angegebenen Teams.

Die folgende URL liefert beispielsweise Videos zu den neuesten Spielen von Real Madrid. Die Zeichenfolge real-madrid ist die eindeutige Kennung (ID) von Real Madrid.

Hier sind die IDs einiger der beliebtesten Teams:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Eine Liste der IDs aller Teams findest du hier.

Livestreams

GET

Liefert ausschließlich Spiele mit verfügbaren offiziellen Livestreams – sowohl aktuell laufende als auch bereits beendete Partien. Einträge erscheinen etwa 5 Minuten vor dem Anpfiff.

  • Zeigt ausschließlich Spiele mit offiziellen, einbettbaren Streams.
  • Enthält laufende und kürzlich beendete Spiele, sofern verfügbar auch mit Wiederholungen des Streams.
  • Einträge erscheinen etwa 5 Minuten vor dem geplanten Anpfiff.

Aktualisierte Endpunkte

GET

Mit diesem Endpunkt kannst du erkennen, welche Feeds für Wettbewerbe oder Teams kürzlich aktualisiert wurden. So musst du nicht jeden einzelnen Endpunkt regelmäßig abfragen.

Antwortstruktur

Die Antwort ist ein JSON-Objekt mit dem Schlüssel response, der ein Array aus Spielobjekten enthält. Jedes Spiel umfasst grundlegende Informationen, Angaben zum zugehörigen Wettbewerb und eine Liste verfügbarer Videos.

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

Der Schlüssel response enthält ein Array aus Spielobjekten. Jedes Objekt steht für ein Fußballspiel und enthält die folgenden Felder:

  • title – Der Name des Spiels (z. B. Chelsea - Manchester United).
  • competition – Der Name des Wettbewerbs (z. B. England Premier League).
  • date – Datum und Uhrzeit des Anpfiffs.
  • thumbnail – Die URL eines Vorschaubilds für das Spiel.
  • videos – Ein Array mit allen verfügbaren Videos zum Spiel. Jedes Videoobjekt enthält:
    • title – Den Titel des Videos (z. B. Highlights oder Extended Highlights).
    • embed – Den HTML-Einbettungscode des Videos.
    • id – Die eindeutige Kennung des Videos.
  • homeTeam / awayTeam – Objekte für die am Spiel beteiligten Teams, einschließlich:
    • name – Den vollständigen Namen des Teams (z. B. Chelsea).
    • slug – Den in URLs verwendeten Team-Slug (z. B. chelsea).
    • id – Die eindeutige Kennung des Teams.
  • matchviewUrl – Die URL der Matchview-Widget-Seite mit ausführlichen Informationen wie Live-Ergebnissen, Statistiken und Tabellen.
  • competitionUrl – Die URL des Wettbewerbs-Widgets mit Live-Tabellen, Ergebnissen und anstehenden Partien.

Automatische Wiedergabe

Du kannst die automatische Wiedergabe aktivieren, indem du der Video-URL den Parameter autoplay=1 hinzufügst.

Zum Beispiel:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Wenn du den embed-HTML-Code direkt verwendest, kannst du innerhalb des iframe-Attributs src den Wert &autoplay=1 an die Video-URL anhängen.

Kontingent

Jeder Tarif enthält ein monatliches Anfragelimit.

  • Jeder Videoaufruf oder jede Anzeige eines Widgets zählt als 1 Anfrage.
  • Jeder Aufruf der Video-API zählt als 5 Anfragen für dein monatliches Kontingent.

Zum Beispiel:

  • Der Starter-Tarif umfasst 5.000 Anfragen pro Monat.
  • Der Standard-Tarif umfasst 20.000 Anfragen pro Monat.
  • Der Advanced-Tarif umfasst 100.000 Anfragen pro Monat.
  • Wenn du ein höheres Limit benötigst, kannst du uns zu unseren Enterprise-Tarifen kontaktieren.

Wenn du dein monatliches Anfragelimit überschreitest, wechselt dein Konto bis zum nächsten Abrechnungszeitraum automatisch zum kostenlosen Tarif. In dieser Zeit erscheinen Werbung und ScoreBat-Logos in Widgets und Videos und nur der Endpunkt Free Feed bleibt verfügbar.