ScoreBat
Strumenti per sviluppatori

API video ufficiale per il calcio

Guida rapida

  1. Ottieni il token di accesso dalla scheda Accesso.
  2. Chiama uno degli endpoint API, ad esempio:
    GET
  3. Analizza la risposta JSON.
  4. Inserisci nella pagina il codice HTML embed di uno dei video presenti nella risposta per mostrare il player. Nelle app mobili puoi visualizzare il video in una webview estraendo l'URL del video dal codice di incorporamento.

Token di accesso

Per utilizzare l'API video è necessario un token di accesso API.

Ogni richiesta deve includere il token di accesso come parametro token nell'URL della richiesta.

Puoi ottenere il token di accesso nella scheda Accesso.

Endpoint

Puoi recuperare i codici di incorporamento dei video in formato JSON dai seguenti endpoint:

Free Feed

GET

L'endpoint Free Feed consente di accedere a una selezione limitata di highlights delle partite. Include campionati selezionati e partite meno recenti, offrendo un'anteprima dell'API video completa.

  • Include solo una parte dei campionati e delle partite, spesso con incontri meno recenti o highlights selezionati.
  • Restituisce video ufficiali e incorporabili provenienti da fonti verificate.
  • Ideale per i test.
  • Non include tutte le competizioni o gli aggiornamenti in tempo reale disponibili nei piani a pagamento.

Featured Feed

GET

Restituisce un feed curato e pertinente che include partite recenti e incontri importanti dei principali campionati e competizioni di calcio. Il feed mette in evidenza le partite più popolari e significative, ma non include ogni incontro. Per accedere a tutti i video di uno specifico campionato o di una squadra, utilizza gli endpoint per competizione o squadra.

  • Include una selezione di partite recenti di vari campionati.
  • Non include tutte le partite o competizioni, ma solo quelle più rilevanti.
  • Disponibile con tutti i piani a pagamento.

Competizione

GET

Puoi cercare i video di qualsiasi competizione tramite l'endpoint Competizione. Questo endpoint restituisce i video delle partite più recenti della competizione specificata.

Ad esempio, l'URL seguente restituisce i video delle partite più recenti della Premier League. La stringa england-premier-league è l'identificativo univoco (ID) della Premier League.

Ecco gli ID di alcune delle competizioni più popolari:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Puoi trovare qui l'elenco degli ID di tutte le competizioni.

Squadra

GET

Puoi cercare i video di qualsiasi squadra tramite l'endpoint Squadra. Questo endpoint restituisce i video delle partite più recenti della squadra specificata.

Ad esempio, l'URL seguente restituisce i video delle partite più recenti di Real Madrid. La stringa real-madrid è l'identificativo univoco (ID) di Real Madrid.

Ecco gli ID di alcune delle squadre più popolari:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Puoi trovare qui l'elenco degli ID di tutte le squadre.

Dirette streaming

GET

Restituisce solo le partite per cui sono disponibili dirette streaming ufficiali, incluse quelle in corso e quelle già terminate. Le voci compaiono circa 5 minuti prima del calcio d'inizio.

  • Mostra esclusivamente partite con streaming ufficiali incorporabili.
  • Include partite in diretta e terminate di recente, con repliche dello streaming quando disponibili.
  • Le voci iniziano a comparire circa 5 minuti prima dell'orario previsto per il calcio d'inizio.

Endpoint aggiornati

GET

Questo endpoint consente di rilevare quali feed di competizioni o squadre sono stati aggiornati di recente, evitando di dover interrogare singolarmente ogni endpoint.

Struttura della risposta

La risposta è un oggetto JSON contenente una chiave response con un array di oggetti partita. Ogni partita include le informazioni di base, i dettagli della competizione e un elenco dei video disponibili.

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

La chiave response contiene un array di oggetti partita. Ogni oggetto rappresenta una partita di calcio e include i seguenti campi:

  • title – Il nome della partita (ad es. Chelsea - Manchester United).
  • competition – Il nome della competizione (ad es. England Premier League).
  • date – La data e l'ora del calcio d'inizio della partita.
  • thumbnail – L'URL dell'immagine di anteprima della partita.
  • videos – Un array contenente tutti i video disponibili per la partita. Ogni oggetto video include:
    • title – Il titolo del video (ad es. Highlights o Extended Highlights).
    • embed – Il codice HTML di incorporamento del video.
    • id – L'identificativo univoco del video.
  • homeTeam / awayTeam – Oggetti che rappresentano le squadre partecipanti alla partita e includono:
    • name – Il nome completo della squadra (ad es. Chelsea).
    • slug – Lo slug della squadra utilizzato negli URL (ad es. chelsea).
    • id – L'identificativo univoco della squadra.
  • matchviewUrl – L'URL della pagina del widget della partita, contenente informazioni dettagliate come risultati in tempo reale, statistiche e classifiche.
  • competitionUrl – L'URL del widget della competizione, che mostra classifiche aggiornate, risultati e prossime partite.

Riproduzione automatica

Puoi attivare la riproduzione automatica aggiungendo il parametro autoplay=1 all'URL del video.

Ad esempio:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Se utilizzi direttamente il codice HTML embed, puoi aggiungere &autoplay=1 all'URL del video all'interno dell'attributo src dell'iframe.

Quota

Ogni piano include un limite mensile di richieste.

  • Ogni visualizzazione di un video o di un widget conta come 1 richiesta.
  • Ogni chiamata all'API video conta come 5 richieste ai fini della quota mensile.

Ad esempio:

  • Il piano Starter include 5.000 richieste al mese.
  • Il piano Standard include 20.000 richieste al mese.
  • Il piano Advanced include 100.000 richieste al mese.
  • Se ti serve un limite superiore, contattaci per scoprire i nostri piani Enterprise.

Se superi il limite mensile di richieste, il tuo account passerà automaticamente al piano gratuito fino al periodo di fatturazione successivo. Durante questo periodo, sui widget e sui video compariranno pubblicità e loghi ScoreBat e resterà accessibile solo l'endpoint Free Feed.