Quickstart: your first request#

Five minutes from nothing to live football data. Everything here uses the free tier.

1. Register and grab your token#

Sign up at /register/, click the email verification link, then copy your API key from the dashboard.

2. Call the API#

Today's matches:

curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/events/?date_from=2026-08-02&date_to=2026-08-02"

{
  "count": 74,
  "next": "https://sports.bzzoiro.com/api/v2/events/?date_from=2026-08-02&date_to=2026-08-02&limit=50&offset=50",
  "previous": null,
  "results": [
    {
      "id": 223510,
      "league_id": 85,
      "season_id": 1635,
      "home_team": "Aldosivi",
      "away_team": "Gimnasia y Esgrima",
      "event_date": "2026-08-02T17:30:00+00:00",
      "status": "upcoming",
      "home_score": null, "away_score": null,
      "live_websocket": true,
      "...": "..."
    }
  ]
}

3. Follow a match live#

# All matches currently in play
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/events/live/"

# Everything about one match
curl -H "Authorization: Token YOUR_API_KEY" \
     "https://sports.bzzoiro.com/api/v2/events/223510/"

Each event exposes sub-resources — statistics, lineups, incidents, head-to-head, odds, predictions:

/api/v2/events/{id}/stats/        shots, possession, xG, shotmap, momentum
/api/v2/events/{id}/lineups/      confirmed XI (or AI-predicted before kickoff)
/api/v2/events/{id}/incidents/    goals, cards, subs, VAR — chronological
/api/v2/events/{id}/h2h/          past meetings and win rates
/api/v2/events/{id}/odds/         consensus decimal odds
/api/v2/events/{id}/prediction/   model probabilities per market

4. Where to go next#

• Build a league page — the full workflow from league id to standings, fixtures and top scorers.
• Football API reference — every endpoint with inputs and outputs.
• Connect to live WebSockets — push updates instead of polling.
• Working with images — logos and player photos for your UI.

Note: football is free. Tennis, CS2, darts, hockey, basketball and horse racing need the Sports Addon ($5/mo) — same token, same conventions, different base path.