ScoreBat
Udviklerværktøjer

Officiel API til fodboldvideoer

Kom hurtigt i gang

  1. Hent dit adgangstoken på adgangsfanen.
  2. Kald et af API-endpointene, for eksempel:
    GET
  3. Fortolk JSON-svaret.
  4. Indsæt embed-HTML'en for en af videoerne i svaret på din side for at vise afspilleren. I mobilapps kan du vise videoen i en webview ved at udtrække videoens URL fra indlejringskoden.

Adgangstoken

Du skal bruge et API-adgangstoken for at benytte Video API'en.

Hver forespørgsel skal indeholde dit adgangstoken som parameteren token i forespørgslens URL.

Du kan hente dit adgangstoken på adgangsfanen.

Endpoints

Du kan hente videoernes indlejringskoder i JSON-format fra følgende endpoints:

Free Feed

GET

Endpointet Free Feed giver adgang til et begrænset udvalg af kamphøjdepunkter. Det omfatter udvalgte ligaer og ældre kampe og giver en smagsprøve på den fulde Video API.

  • Omfatter kun et udvalg af ligaer og kampe, ofte ældre kampe eller udvalgte højdepunkter.
  • Returnerer officielle videoer fra verificerede kilder, som kan indlejres.
  • Ideel til test.
  • Omfatter ikke alle turneringer eller liveopdateringer, der er tilgængelige i betalte planer.

Featured Feed

GET

Returnerer et kurateret og relevant feed med både nylige og vigtige kampe fra de største fodboldligaer og -turneringer. Feedet fremhæver de mest populære og bemærkelsesværdige kampe, men omfatter ikke alle kampe. Brug endpointet til turneringer eller hold for at få adgang til alle videoer fra en bestemt liga eller et bestemt hold.

  • Omfatter et udvalg af nylige kampe fra forskellige ligaer.
  • Omfatter ikke alle kampe eller turneringer — kun de mest relevante.
  • Tilgængeligt i alle betalte planer.

Turnering

GET

Du kan hente videoer fra enhver turnering via endpointet Turnering. Endpointet returnerer videoer fra de seneste kampe i den angivne turnering.

URL'en nedenfor returnerer for eksempel videoer fra de seneste kampe i Premier League. Strengen england-premier-league er Premier Leagues unikke identifikator (ID).

Her er ID'erne for nogle af de mest populære turneringer:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Du kan finde en liste over ID'er for alle turneringer her.

Hold

GET

Du kan hente videoer for ethvert hold via endpointet Hold. Endpointet returnerer videoer fra de seneste kampe med det angivne hold.

URL'en nedenfor returnerer for eksempel videoer fra de seneste kampe med Real Madrid. Strengen real-madrid er det unikke ID for Real Madrid.

Her er ID'erne for nogle af de mest populære hold:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Du kan finde en liste over ID'er for alle hold her.

Livestreams

GET

Returnerer kun kampe med tilgængelige officielle livestreams — både igangværende og allerede afsluttede kampe. Elementerne vises cirka 5 minutter før kampstart.

  • Viser kun kampe med officielle streams, som kan indlejres.
  • Omfatter igangværende og nyligt afsluttede kampe, med genudsendelser når de er tilgængelige.
  • Elementerne begynder at blive vist cirka 5 minutter før den planlagte kampstart.

Opdaterede endpoints

GET

Dette endpoint gør det muligt at se, hvilke feeds for turneringer eller hold der er blevet opdateret for nylig, så du ikke behøver at forespørge hvert enkelt endpoint løbende.

Svarstruktur

Svaret er et JSON-objekt med nøglen response, som indeholder et array af kampobjekter. Hver kamp indeholder grundlæggende oplysninger, oplysninger om den tilknyttede turnering og en liste over tilgængelige videoer.

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

Nøglen response indeholder et array af kampobjekter. Hvert objekt repræsenterer en fodboldkamp og indeholder følgende felter:

  • title – Kampens navn (f.eks. Chelsea - Manchester United).
  • competition – Turneringens navn (f.eks. England Premier League).
  • date – Dato og tidspunkt for kampstart.
  • thumbnail – URL'en til kampens miniaturebillede.
  • videos – Et array med alle tilgængelige videoer fra kampen. Hvert videoobjekt indeholder:
    • title – Videoens titel (f.eks. Highlights eller Extended Highlights).
    • embed – Videoens HTML-indlejringskode.
    • id – Videoens unikke identifikator.
  • homeTeam / awayTeam – Objekter, der repræsenterer holdene i kampen, herunder:
    • name – Holdets fulde navn (f.eks. Chelsea).
    • slug – Holdets slug, som bruges i URL'er (f.eks. chelsea).
    • id – Holdets unikke identifikator.
  • matchviewUrl – URL'en til kampvisningens widgetside, som indeholder detaljer såsom liveresultater, statistik og stillinger.
  • competitionUrl – URL'en til turneringswidgetten, som viser live-tabeller, resultater og kommende kampe.

Automatisk afspilning

Du kan aktivere automatisk afspilning ved at føje parameteren autoplay=1 til videoens URL.

For eksempel:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Hvis du bruger embed-HTML'en direkte, kan du føje &autoplay=1 til videoens URL i iframe-attributten src.

Kvote

Hver plan har en månedlig forespørgselsgrænse.

  • Hver videovisning eller visning af en widget tæller som 1 forespørgsel.
  • Hvert kald til Video API'en tæller som 5 forespørgsler i din månedlige kvote.

For eksempel:

  • Starter-planen inkluderer 5.000 forespørgsler om måneden.
  • Standard-planen inkluderer 20.000 forespørgsler om måneden.
  • Advanced-planen inkluderer 100.000 forespørgsler om måneden.
  • Har du brug for en højere grænse, kan du kontakte os om vores Enterprise-planer.

Hvis du overskrider din månedlige forespørgselsgrænse, skifter din konto automatisk til gratisplanen indtil næste faktureringsperiode. I denne periode vises annoncer og ScoreBat-logoer på widgets og videoer, og kun endpointet Free Feed er tilgængeligt.