ScoreBat
Instrumente pentru dezvoltatori

API video oficial pentru fotbal

Pornire rapidă

  1. Obține tokenul de acces din fila de acces.
  2. Apelează unul dintre endpointurile API, de exemplu:
    GET
  3. Procesează răspunsul JSON.
  4. Inserează în pagină codul HTML embed al unuia dintre videoclipurile din răspuns pentru a afișa playerul. În aplicațiile mobile, poți afișa videoclipul într-un webview extrăgând URL-ul acestuia din codul de încorporare.

Token de acces

Ai nevoie de un token de acces API pentru a utiliza API-ul video.

Fiecare cerere trebuie să includă tokenul de acces ca parametru token în URL-ul cererii.

Poți obține tokenul de acces din fila de acces.

Endpointuri

Poți prelua codurile de încorporare ale videoclipurilor în format JSON din următoarele endpointuri:

Free Feed

GET

Endpointul Free Feed oferă acces la un set limitat de rezumate ale meciurilor. Include anumite ligi și meciuri mai vechi, oferind o previzualizare a API-ului video complet.

  • Include doar o parte dintre ligi și meciuri, adesea meciuri mai vechi sau rezumate selectate.
  • Returnează videoclipuri oficiale, care pot fi încorporate, din surse verificate.
  • Ideal pentru testare.
  • Nu include toate competițiile sau actualizările live disponibile în planurile plătite.

Featured Feed

GET

Returnează un flux relevant, selectat editorial, care include atât meciuri recente, cât și partide importante din principalele ligi și competiții de fotbal. Fluxul evidențiază cele mai populare și importante meciuri, dar nu le include pe toate. Pentru a accesa toate videoclipurile pentru o anumită ligă sau echipă, folosește endpointurile pentru competiții sau echipe.

  • Include o selecție de meciuri recente din mai multe ligi.
  • Nu include toate meciurile sau competițiile — doar pe cele mai relevante.
  • Disponibil în toate planurile plătite.

Competiție

GET

Poți căuta videoclipuri pentru orice competiție folosind endpointul Competiție. Acesta returnează videoclipuri de la cele mai recente meciuri din competiția specificată.

De exemplu, URL-ul de mai jos returnează videoclipuri de la cele mai recente meciuri din Premier League. Șirul england-premier-league este identificatorul unic (ID) pentru Premier League.

Iată ID-urile câtorva dintre cele mai populare competiții:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Poți găsi lista ID-urilor tuturor competițiilor aici.

Echipă

GET

Poți căuta videoclipuri pentru orice echipă folosind endpointul Echipă. Acesta returnează videoclipuri de la cele mai recente meciuri ale echipei specificate.

De exemplu, URL-ul de mai jos returnează videoclipuri de la cele mai recente meciuri pentru Real Madrid. Șirul real-madrid este identificatorul unic (ID) pentru Real Madrid.

Iată ID-urile câtorva dintre cele mai populare echipe:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Poți găsi lista ID-urilor tuturor echipelor aici.

Transmisiuni live

GET

Returnează numai meciurile pentru care sunt disponibile transmisiuni live oficiale, inclusiv meciurile în desfășurare și cele deja încheiate. Elementele apar cu aproximativ 5 minute înainte de start.

  • Afișează numai meciuri cu transmisiuni oficiale care pot fi încorporate.
  • Include meciuri live și încheiate recent, cu reluări ale transmisiunilor acolo unde sunt disponibile.
  • Elementele încep să apară cu aproximativ 5 minute înainte de ora programată a meciului.

Endpointuri actualizate

GET

Acest endpoint îți permite să identifici fluxurile de competiții sau echipe actualizate recent, eliminând necesitatea de a interoga separat fiecare endpoint.

Structura răspunsului

Răspunsul este un obiect JSON care conține o cheie response cu o listă de obiecte reprezentând meciuri. Fiecare meci include informațiile de bază, detalii despre competiție și o listă cu videoclipurile disponibile.

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

Cheia response conține o listă de obiecte reprezentând meciuri. Fiecare obiect reprezintă un meci de fotbal și include următoarele câmpuri:

  • title – Numele meciului (de exemplu, Chelsea - Manchester United).
  • competition – Numele competiției (de exemplu, England Premier League).
  • date – Data și ora de start ale meciului.
  • thumbnail – URL-ul unei imagini miniaturale pentru meci.
  • videos – O listă cu toate videoclipurile disponibile pentru meci. Fiecare obiect video include:
    • title – Titlul videoclipului (de exemplu, Highlights sau Extended Highlights).
    • embed – Codul HTML pentru încorporarea videoclipului.
    • id – Identificatorul unic al videoclipului.
  • homeTeam / awayTeam – Obiecte care reprezintă echipele participante la meci și includ:
    • name – Numele complet al echipei (de exemplu, Chelsea).
    • slug – Slugul echipei utilizat în URL-uri (de exemplu, chelsea).
    • id – Identificatorul unic al echipei.
  • matchviewUrl – URL-ul paginii widgetului pentru meci, care conține informații detaliate precum scoruri live, statistici și clasamente.
  • competitionUrl – URL-ul widgetului competiției, care afișează clasamente live, rezultate și meciurile următoare.

Redare automată

Poți activa redarea automată adăugând parametrul autoplay=1 la URL-ul videoclipului.

De exemplu:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Dacă folosești direct codul HTML embed, poți adăuga &autoplay=1 la URL-ul videoclipului din atributul src al iframe-ului.

Cotă

Fiecare plan include o limită lunară de cereri.

  • Fiecare vizionare video sau afișare a unui widget este contorizată ca 1 cerere.
  • Fiecare apel către API-ul video este contorizat ca 5 cereri din cota lunară.

De exemplu:

  • Planul Starter include 5.000 de cereri pe lună.
  • Planul Standard include 20.000 de cereri pe lună.
  • Planul Advanced include 100.000 de cereri pe lună.
  • Dacă ai nevoie de o limită mai mare, contactează-ne pentru planurile Enterprise.

Dacă depășești limita lunară de cereri, contul tău va trece automat la planul gratuit până la următoarea perioadă de facturare. În acest interval, reclamele și siglele ScoreBat vor apărea în widgeturi și videoclipuri și va rămâne accesibil numai endpointul Free Feed.