Bearer API key
Ogni chiamata dati richiede una chiave personale nell'header Authorization.
Authorization: Bearer sb_live_…
Basketball data infrastructure
Dati basket pronti per il tuo prodotto.
Live score, calendario, tabellino, play-by-play, statistiche per periodo e classifiche tramite un gateway REST versionato e di sola lettura.
Autenticazione
Scope di prodotto
La chiave abilita soltanto i moduli acquistati e può essere limitata a specifiche competizioni.
live:read · boxscore:read · pbp:read
Rate limit dedicato
Ogni risposta espone limite, richieste residue e istante di reset negli header HTTP.
X-RateLimit-Remaining
Endpoint disponibili
| Metodo | Endpoint | Scope | Contenuto |
|---|---|---|---|
| GET | /matches | calendar:read | Elenco gare filtrabile per competizione, stagione, girone e stato. |
| GET | /matches/{id}/live | live:read | Punteggio, periodo, cronometro, falli, timeout e parziali. |
| GET | /matches/{id}/boxscore | boxscore:read | Statistiche complete di squadra e giocatore. |
| GET | /matches/{id}/play-by-play | pbp:read | Azioni ordinate e paginazione incrementale con after_seq. |
| GET | /matches/{id}/periods | live:read / boxscore:read | Parziali e statistiche suddivise per periodo. |
| GET | /matches/{id}/shots | shots:read | Shot map con coordinate, esito, giocatore e zona di tiro. |
| GET | /matches/{id}/lineups | lineups:read | Roster, quintetti iniziali e attuali, più stint e plus/minus. |
| GET | /matches/{id}/boxscore.pdf | pdf:read | PDF ufficiale del tabellino, generato dal motore FIBA o LNP. |
| GET | /matches/{id}/commentary | ai:read | Ultima telecronaca AI già generata; non avvia nuove elaborazioni. |
| GET | /standings | rankings:read | Classifica calcolata per competizione e stagione. |
Tester API
La chiave resta soltanto nella memoria di questa pagina: non viene salvata nel browser. Per gli endpoint gara inserisci l'ID StatBasket.
In attesa
La risposta JSON apparirà qui.
Quick start
curl "https://api.statbasket.it/v1/data/matches?limit=10" \ -H "Authorization: Bearer $STATBASKET_API_KEY"
const response = await fetch(
"https://api.statbasket.it/v1/data/matches/90/live",
{ headers: { Authorization: `Bearer ${STATBASKET_API_KEY}` } }
);
const data = await response.json();
Realtime WebSocket
Il canale commerciale invia lo stesso payload normalizzato dell'endpoint live REST e pubblica un nuovo messaggio soltanto quando i dati cambiano.
const socket = new WebSocket(
"wss://api.statbasket.it/ws/?mode=api&match=90",
["statbasket", STATBASKET_API_KEY]
);
socket.onmessage = event => {
const update = JSON.parse(event.data);
console.log(update);
};
Richiede lo scope live:read. La chiave viene trasmessa come sottoprotocollo WebSocket, non nell'URL. Limite predefinito: 3 connessioni contemporanee per chiave. Sono applicati quota mensile e autorizzazioni per competizione.
Accesso commerciale
Live Score Core
Calendario e stato live per scoreboard, siti, app e media center.
calendar:read · live:readGame Data
Boxscore, play-by-play incrementale e statistiche per periodo.
boxscore:read · pbp:readCompetition Data
Classifiche e accesso delimitato alle competizioni autorizzate.
rankings:read · competition:{id}PDF e contenuti AI sono moduli premium separati. La lettura della telecronaca è disponibile ai clienti autorizzati; la generazione resta riservata agli amministratori StatBasket.