ScoreBat
Utviklerverktøy

Offisielt API for fotballvideoer

Hurtigstart

  1. Hent tilgangstokenet ditt fra tilgangsfanen.
  2. Kall et av API-endepunktene, for eksempel:
    GET
  3. Tolk JSON-svaret.
  4. Sett inn embed-HTML-koden til en av videoene i svaret på siden din for å vise avspilleren. I mobilapper kan du vise videoen i en webvisning ved å hente ut videoens URL fra innebyggingskoden.

Tilgangstoken

Du trenger et API-tilgangstoken for å bruke Video API.

Hver forespørsel må inneholde tilgangstokenet ditt som parameteren token i forespørsels-URL-en.

Du kan hente tilgangstokenet ditt i tilgangsfanen.

Endepunkter

Du kan hente videoenes innebyggingskoder i JSON-format fra følgende endepunkter:

Free Feed

GET

Endepunktet Free Feed gir tilgang til et begrenset utvalg kamphøydepunkter. Det omfatter utvalgte ligaer og eldre kamper og gir en forhåndsvisning av hele Video API.

  • Omfatter bare et utvalg ligaer og kamper, ofte eldre kamper eller utvalgte høydepunkter.
  • Returnerer offisielle videoer fra verifiserte kilder som kan bygges inn.
  • Ideelt for testing.
  • Omfatter ikke alle turneringer eller sanntidsoppdateringer som er tilgjengelige i betalingsplanene.

Featured Feed

GET

Returnerer en kuratert og relevant feed med både nylige og viktige kamper fra de største fotballigaene og turneringene. Feeden fremhever de mest populære og bemerkelsesverdige kampene, men inkluderer ikke alle kamper. Bruk endepunktene for turneringer eller lag for å få tilgang til alle videoer for en bestemt liga eller et bestemt lag.

  • Inneholder et utvalg nylige kamper fra ulike ligaer.
  • Inneholder ikke alle kamper eller turneringer – bare de mest relevante.
  • Tilgjengelig i alle betalingsplaner.

Turnering

GET

Du kan hente videoer for alle turneringer via endepunktet Turnering. Endepunktet returnerer videoer fra de nyeste kampene i den valgte turneringen.

URL-en nedenfor returnerer for eksempel videoer fra de nyeste kampene i Premier League. Strengen england-premier-league er den unike identifikatoren (ID-en) for Premier League.

Her er ID-ene til noen av de mest populære turneringene:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Du finner en liste over ID-ene til alle turneringer her.

Lag

GET

Du kan hente videoer for alle lag via endepunktet Lag. Endepunktet returnerer videoer fra de nyeste kampene til det valgte laget.

URL-en nedenfor returnerer for eksempel videoer fra de nyeste kampene til Real Madrid. Strengen real-madrid er den unike identifikatoren (ID-en) for Real Madrid.

Her er ID-ene til noen av de mest populære lagene:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Du finner en liste over ID-ene til alle lag her.

Direktesendinger

GET

Returnerer bare kamper med tilgjengelige offisielle direktesendinger – både kamper som pågår og kamper som allerede er avsluttet. Oppføringer vises omtrent 5 minutter før avspark.

  • Viser bare kamper med offisielle sendinger som kan bygges inn.
  • Omfatter pågående og nylig avsluttede kamper, med opptak av sendingen der dette er tilgjengelig.
  • Oppføringer begynner å vises omtrent 5 minutter før planlagt avspark.

Oppdaterte endepunkter

GET

Dette endepunktet lar deg oppdage hvilke feeder for turneringer eller lag som nylig er oppdatert, slik at du slipper å kontrollere hvert enkelt endepunkt.

Svarstruktur

Svaret er et JSON-objekt som inneholder en response-nøkkel med en liste over kampobjekter. Hver kamp inneholder grunnleggende informasjon, tilknyttede turneringsdetaljer og en liste over tilgjengelige 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økkelen response inneholder en liste over kampobjekter. Hvert objekt representerer en fotballkamp og inneholder følgende felt:

  • title – Navnet på kampen (f.eks. Chelsea - Manchester United).
  • competition – Navnet på turneringen (f.eks. England Premier League).
  • date – Dato og klokkeslett for kampstart.
  • thumbnail – URL-en til et miniatyrbilde for kampen.
  • videos – En liste over alle tilgjengelige videoer for kampen. Hvert videoobjekt inneholder:
    • title – Tittelen på videoen (f.eks. Highlights eller Extended Highlights).
    • embed – HTML-koden for å bygge inn videoen.
    • id – Videoens unike identifikator.
  • homeTeam / awayTeam – Objekter som representerer lagene i kampen, inkludert:
    • name – Lagets fulle navn (f.eks. Chelsea).
    • slug – Lagets slug som brukes i URL-er (f.eks. chelsea).
    • id – Lagets unike identifikator.
  • matchviewUrl – URL-en til kampvisningswidgeten, med detaljert informasjon som liveresultater, statistikk og tabeller.
  • competitionUrl – URL-en til turneringswidgeten, som viser oppdaterte tabeller, resultater og kommende kamper.

Automatisk avspilling

Du kan aktivere automatisk avspilling ved å legge til parameteren autoplay=1 i videoens URL.

For eksempel:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Hvis du bruker embed-HTML direkte, kan du legge til &autoplay=1 i videoens URL inne i iframe-attributtet src.

Kvote

Hver plan har en månedlig forespørselsgrense.

  • Hver videoavspilling eller visning av en widget teller som 1 forespørsel.
  • Hvert kall til Video API teller som 5 forespørsler i den månedlige kvoten.

For eksempel:

  • Starter-planen inkluderer 5 000 forespørsler per måned.
  • Standard-planen inkluderer 20 000 forespørsler per måned.
  • Advanced-planen inkluderer 100 000 forespørsler per måned.
  • Hvis du trenger en høyere grense, kan du kontakte oss om våre Enterprise-planer.

Hvis du overskrider den månedlige forespørselsgrensen, bytter kontoen automatisk til gratisplanen frem til neste faktureringsperiode. I denne perioden vises reklame og ScoreBat-logoer i widgeter og videoer, og bare Free Feed-endepunktet er tilgjengelig.