ScoreBat
Utvecklarverktyg

Officiellt API för fotbollsvideor

Snabbstart

  1. Hämta din åtkomsttoken på åtkomstfliken.
  2. Anropa en av API-endpointsen, till exempel:
    GET
  3. Tolka JSON-svaret.
  4. Infoga HTML-koden från embed för någon av videorna i svaret på din sida för att visa spelaren. I mobilappar kan du visa videon i en webview genom att hämta video-URL:en från inbäddningskoden.

Åtkomsttoken

Du behöver en API-åtkomsttoken för att använda Video API.

Varje anrop måste innehålla din åtkomsttoken som parametern token i anropets URL.

Du hittar din åtkomsttoken på åtkomstfliken.

Endpoints

Du kan hämta videornas inbäddningskod i JSON-format från följande endpoints:

Free Feed

GET

Endpointen Free Feed ger tillgång till ett begränsat urval av matchhöjdpunkter. Den omfattar utvalda ligor och äldre matcher och ger en förhandsvisning av hela Video API.

  • Omfattar endast ett urval av ligor och matcher, ofta äldre matcher eller utvalda höjdpunkter.
  • Returnerar officiella videor från verifierade källor som kan bäddas in.
  • Passar bra för testning.
  • Omfattar inte alla turneringar eller liveuppdateringar som finns i betalplanerna.

Featured Feed

GET

Returnerar ett kurerat och relevant flöde med både aktuella och viktiga matcher från de främsta fotbollsligorna och turneringarna. Flödet lyfter fram de mest populära och uppmärksammade matcherna, men innehåller inte alla matcher. Använd endpointen för turneringar eller lag för att få tillgång till alla videor för en viss liga eller ett visst lag.

  • Innehåller ett urval av aktuella matcher från olika ligor.
  • Innehåller inte alla matcher eller turneringar – endast de mest relevanta.
  • Tillgänglig med alla betalplaner.

Turnering

GET

Du kan söka efter videor för valfri turnering via endpointen Turnering. Den returnerar videor från de senaste matcherna i den angivna turneringen.

URL:en nedan returnerar exempelvis videor från de senaste matcherna i Premier League. Strängen england-premier-league är Premier Leagues unika identifierare (ID).

Här är ID:n för några av de populäraste turneringarna:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Du hittar en lista över ID:n för alla turneringar här.

Lag

GET

Du kan söka efter videor för valfritt lag via endpointen Lag. Den returnerar videor från de senaste matcherna för det angivna laget.

URL:en nedan returnerar exempelvis videor från de senaste matcherna med Real Madrid. Strängen real-madrid är den unika identifieraren (ID) för Real Madrid.

Här är ID:n för några av de populäraste lagen:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Du hittar en lista över ID:n för alla lag här.

Direktsändningar

GET

Returnerar endast matcher med tillgängliga officiella direktsändningar – både pågående och redan avslutade matcher. Poster visas cirka 5 minuter före avspark.

  • Visar endast matcher med officiella sändningar som kan bäddas in.
  • Omfattar pågående och nyligen avslutade matcher, med repriser när sådana finns.
  • Poster börjar visas cirka 5 minuter före planerad avspark.

Uppdaterade endpoints

GET

Med denna endpoint kan du se vilka turnerings- eller lagflöden som nyligen har uppdaterats, så att du slipper kontrollera varje enskild endpoint.

Svarsstruktur

Svaret är ett JSON-objekt med nyckeln response, som innehåller en lista med matchobjekt. Varje match innehåller grundläggande information, uppgifter om turneringen och en lista över tillgängliga videor.

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

Nyckeln response innehåller en lista med matchobjekt. Varje objekt representerar en fotbollsmatch och innehåller följande fält:

  • title – Matchens namn (t.ex. Chelsea - Manchester United).
  • competition – Turneringens namn (t.ex. England Premier League).
  • date – Datum och tid för matchens avspark.
  • thumbnail – URL:en till en miniatyrbild för matchen.
  • videos – En lista över alla tillgängliga videor för matchen. Varje videoobjekt innehåller:
    • title – Videons titel (t.ex. Highlights eller Extended Highlights).
    • embed – HTML-koden för att bädda in videon.
    • id – Videons unika identifierare.
  • homeTeam / awayTeam – Objekt som representerar lagen i matchen och innehåller:
    • name – Lagets fullständiga namn (t.ex. Chelsea).
    • slug – Lagets slug som används i URL:er (t.ex. chelsea).
    • id – Lagets unika identifierare.
  • matchviewUrl – URL:en till matchsidan i widgeten, med detaljerad information som liveresultat, statistik och tabeller.
  • competitionUrl – URL:en till turneringswidgeten, som visar livetabeller, resultat och kommande matcher.

Spela upp automatiskt

Du kan aktivera automatisk uppspelning genom att lägga till parametern autoplay=1 i video-URL:en.

Till exempel:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Om du använder HTML-koden från embed direkt kan du lägga till &autoplay=1 i video-URL:en inuti iframe-attributet src.

Kvot

Varje plan har en månatlig anropsgräns.

  • Varje videovisning eller visning av en widget räknas som 1 anrop.
  • Varje anrop till Video API räknas som 5 anrop mot din månadskvot.

Till exempel:

  • Starter-planen omfattar 5 000 anrop per månad.
  • Standard-planen omfattar 20 000 anrop per månad.
  • Advanced-planen omfattar 100 000 anrop per månad.
  • Behöver du en högre gräns kan du kontakta oss om våra Enterprise-planer.

Om du överskrider den månatliga anropsgränsen växlar kontot automatiskt till gratisplanen fram till nästa faktureringsperiod. Under tiden visas reklam och ScoreBat-logotyper i widgetar och videor, och endast endpointen Free Feed är tillgänglig.