Matches
- Status and score
- Live minute
- Matchday
- Stadium, referee and attendance
Football API
REST JSON and SSE streams for fan apps, sports media and odds products. Multiple competitions, on-demand detail and token authentication.
No live games right now
See the calendar in the demo.
What you get
Normalized JSON data, grouped by domain — from scores to odds markets.
Leagues
From Brasileirão to Champions. The server exposes only active leagues in LIGAS_ATIVAS.
brasileiraoseriebrcopalibertadoressulamericanacopadobrasilchampionspremierlaligaPricing
Fixed monthly fee with clear REST request and SSE connection limits. 14-day trial with 1,000 req/day. No surprise charges when limits are exceeded — blocked with HTTP 429.
R$ 349/mo
R$ 699/mo
R$ 499/mo · 6 months
Same usage as Scale · 5 spots · 6 months
R$ 1.199/mo
+5,000 req/day
+R$ 149/mo
+1 simultaneous SSE
+R$ 99/mo
+1 league (Launch)
+R$ 79/mo
Extra environment (token)
+R$ 149/mo
Enterprise on request — SLA, custom limits and dedicated support. Contact us
Integration
Authenticate with Bearer, X-API-Token header or ?api_token= query.
JSON endpoints for queries and live stream for real-time events.
Match detail (lineups, odds, stats) loaded lazily on the server.
Examples
curl -H "Authorization: Bearer SEU_TOKEN" \
https://api.exemplo.com/api/brasileirao/partidas/ao-vivoconst res = await fetch(
"https://api.exemplo.com/api/brasileirao/resumo",
{ headers: { Authorization: "Bearer SEU_TOKEN" } }
);
const resumo = await res.json();const es = new EventSource(
"https://api.exemplo.com/api/brasileirao/stream/ao-vivo?api_token=SEU_TOKEN"
);
es.addEventListener("evento", (e) => console.log(JSON.parse(e.data)));Use cases
Live scores, goal notifications and matchday calendar in your product.
Internal panels, sports coverage and embeddable widgets with unified data.
Pre-match and live markets with provider, line and capture timestamp.
SSE alerts when a goal, card or match status change occurs.
Reference
REST + SSE contract. Replace {liga} with the competition slug.
| Method | Path | Description |
|---|---|---|
| GET | /api/ligasList available competitions | List available competitions |
| GET | /api/{liga}/infoCompetition metadata | Competition metadata |
| GET | /api/{liga}/resumoMatchday counters | Matchday counters |
| GET | /api/{liga}/calendarioAll matches sorted | All matches sorted |
| GET | /api/{liga}/classificacaoStandings table | Standings table |
| GET | /api/{liga}/timesTeam catalog | Team catalog |
| GET | /api/{liga}/times/{id}Single team profile | Single team profile |
| GET | /api/{liga}/partidas/ao-vivoMatches in progress | Matches in progress |
| GET | /api/{liga}/partidas/hojeToday's matches (SP timezone) | Today's matches (SP timezone) |
| GET | /api/{liga}/partidas/{id}Match with enriched detail | Match with enriched detail |
| GET | /api/{liga}/partidas/{id}/eventosMatch events | Match events |
| GET | /api/{liga}/partidas/{id}/escalacoesLineups | Lineups |
| GET | /api/{liga}/partidas/{id}/oddsAvailable odds | Available odds |
| SSE | /api/{liga}/stream/ao-vivoLive event stream | Live event stream |
| GET | /api/usageDaily token usage (req + SSE) | Daily token usage (req + SSE) |
| GET | /healthOperational status per league | Operational status per league |
Ready to integrate?
Send a message and receive API credentials. Check the live demo in the meantime.
contato@baseup.cc