ScoreBat
Tools voor ontwikkelaars

Officiële voetbalvideo-API

Snel aan de slag

  1. Haal je toegangstoken op via het toegangstabblad.
  2. Roep een van de API-endpoints aan, bijvoorbeeld:
    GET
  3. Verwerk het JSON-antwoord.
  4. Plaats de embed-HTML van een van de video's uit het antwoord op je pagina om de speler weer te geven. In mobiele apps kun je de video in een webview tonen door de video-URL uit de insluitcode te halen.

Toegangstoken

Je hebt een API-toegangstoken nodig om de Video-API te gebruiken.

Elke aanvraag moet je toegangstoken als de parameter token in de aanvraag-URL bevatten.

Je vindt je toegangstoken op het toegangstabblad.

Endpoints

Je kunt via de volgende endpoints de insluitcodes van video's in JSON-indeling ophalen:

Free Feed

GET

Het endpoint Free Feed geeft toegang tot een beperkt aanbod aan wedstrijdhighlights. Het bevat geselecteerde competities en oudere wedstrijden en biedt zo een voorproefje van de volledige Video-API.

  • Bevat slechts een deel van de competities en wedstrijden, vaak oudere wedstrijden of geselecteerde highlights.
  • Retourneert officiële, insluitbare video's uit geverifieerde bronnen.
  • Ideaal om te testen.
  • Bevat niet alle competities of live-updates die in betaalde abonnementen beschikbaar zijn.

Featured Feed

GET

Retourneert een samengestelde, relevante feed met zowel recente als belangrijke wedstrijden uit de grootste voetbalcompetities en toernooien. De feed benadrukt de populairste en opvallendste wedstrijden, maar bevat niet elke wedstrijd. Gebruik de endpoints voor competities of teams om alle video's van een specifieke competitie of een specifiek team op te halen.

  • Bevat een selectie van recente wedstrijden uit verschillende competities.
  • Bevat niet alle wedstrijden of competities, maar alleen de relevantste.
  • Beschikbaar bij alle betaalde abonnementen.

Competitie

GET

Met het endpoint Competitie kun je video's van elke competitie opvragen. Dit endpoint retourneert video's van de nieuwste wedstrijden in de opgegeven competitie.

De onderstaande URL retourneert bijvoorbeeld video's van de meest recente wedstrijden in de Premier League. De tekenreeks england-premier-league is de unieke identificatiecode (ID) van de Premier League.

Dit zijn de ID's van enkele populaire competities:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Je vindt hier de lijst met ID's van alle competities.

Team

GET

Met het endpoint Team kun je video's van elk team opvragen. Dit endpoint retourneert video's van de nieuwste wedstrijden van het opgegeven team.

De onderstaande URL retourneert bijvoorbeeld video's van de meest recente wedstrijden van Real Madrid. De tekenreeks real-madrid is de unieke identificatiecode (ID) van Real Madrid.

Dit zijn de ID's van enkele populaire teams:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Je vindt hier de lijst met ID's van alle teams.

Livestreams

GET

Retourneert alleen wedstrijden waarvoor officiële livestreams beschikbaar zijn, waaronder zowel lopende als al afgelopen wedstrijden. Items verschijnen ongeveer 5 minuten voor de aftrap.

  • Toont alleen wedstrijden met officiële, insluitbare streams.
  • Bevat live en onlangs afgelopen wedstrijden, inclusief herhalingen van streams indien beschikbaar.
  • Items verschijnen ongeveer 5 minuten voor de geplande aftrap.

Bijgewerkte endpoints

GET

Met dit endpoint kun je zien welke feeds van competities of teams onlangs zijn bijgewerkt. Zo hoef je niet elk afzonderlijk endpoint voortdurend op nieuwe gegevens te controleren.

Structuur van het antwoord

Het antwoord is een JSON-object met een sleutel response die een array met wedstrijdobjecten bevat. Elke wedstrijd bevat basisinformatie, gegevens over de bijbehorende competitie en een lijst met beschikbare video's.

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

De sleutel response bevat een array met wedstrijdobjecten. Elk object vertegenwoordigt een voetbalwedstrijd en bevat de volgende velden:

  • title – De naam van de wedstrijd (bijvoorbeeld Chelsea - Manchester United).
  • competition – De naam van de competitie (bijvoorbeeld England Premier League).
  • date – De datum en tijd van de aftrap.
  • thumbnail – De URL van een miniatuurafbeelding voor de wedstrijd.
  • videos – Een array met alle beschikbare video's voor de wedstrijd. Elk video-object bevat:
    • title – De titel van de video (bijvoorbeeld Highlights of Extended Highlights).
    • embed – De HTML-insluitcode van de video.
    • id – De unieke identificatiecode van de video.
  • homeTeam / awayTeam – Objecten die de deelnemende teams van de wedstrijd vertegenwoordigen, waaronder:
    • name – De volledige naam van het team (bijvoorbeeld Chelsea).
    • slug – De slug van het team die in URL's wordt gebruikt (bijvoorbeeld chelsea).
    • id – De unieke identificatiecode van het team.
  • matchviewUrl – De URL van de wedstrijdwidgetpagina met gedetailleerde informatie, zoals live uitslagen, statistieken en standen.
  • competitionUrl – De URL van de competitiewidget met live standen, uitslagen en komende wedstrijden.

Automatisch afspelen

Je kunt automatisch afspelen inschakelen door de parameter autoplay=1 aan de video-URL toe te voegen.

Bijvoorbeeld:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Als je de embed-HTML rechtstreeks gebruikt, kun je &autoplay=1 toevoegen aan de video-URL in de src van het iframe.

Limiet

Elk abonnement heeft een maandelijkse aanvraaglimiet.

  • Elke videoweergave of weergave van een widget telt als 1 aanvraag.
  • Elke aanroep van de Video-API telt als 5 aanvragen voor je maandelijkse quotum.

Bijvoorbeeld:

  • Het Starter-abonnement bevat 5.000 aanvragen per maand.
  • Het Standard-abonnement bevat 20.000 aanvragen per maand.
  • Het Advanced-abonnement bevat 100.000 aanvragen per maand.
  • Heb je een hogere limiet nodig? Neem contact met ons op voor onze Enterprise-abonnementen.

Als je de maandelijkse aanvraaglimiet overschrijdt, schakelt je account tot de volgende factureringsperiode automatisch over op het gratis abonnement. In die periode worden advertenties en ScoreBat-logo's op widgets en video's weergegeven en blijft alleen het endpoint Free Feed toegankelijk.