Basketball API.

Quick start

All endpoints under /basketball/api/v2/. Authentication via DRF token in the Authorization header. The Sports Pack ($5/mo) unlocks tennis, basketball, hockey, darts, and CS:GO API + MCP access.

GET/basketball/api/v2/leagues/

List active basketball leagues.

Param	Type	Description
country	str	Filter by country (e.g. USA, Spain)
limit	int	Default 50, max 200

GET/basketball/api/v2/teams/

List teams sorted by ELO. Filter by country code.

GET/basketball/api/v2/events/

List events. Default returns next 7 days.

Param	Type	Description
date_from	YYYY-MM-DD	Start of date window
date_to	YYYY-MM-DD	End of date window
league	int / str	League id or name
team	int / str	Team id or name (filters home OR away)
status	str	scheduled / live / finished

GET/basketball/api/v2/events/<id>/

Single event with periods + prediction.

GET/basketball/api/v2/events/<id>/box-score/

Per-player box score (PTS / REB / AST / STL / BLK / TO / FG / 3P / FT / +/- / TS% / rating). Starters marked. Split into home_box + away_box.

GET/basketball/api/v2/events/<id>/team-stats/

Team-level scoring/rebound/lead breakdown by quarter + game-total. Each entry has name, home, away.

GET/basketball/api/v2/players/

List players. Filter by team, country_code, position (G, F, C, GF, CF), or search.

GET/basketball/api/v2/players/<id>/

Player detail with season averages: ppg, rpg, apg, spg, bpg, topg, field_goal_pct, usage_pct, total points.

GET/basketball/api/v2/players/<id>/games/

Recent box-score lines for a player (game log). Default 20, max 100.

GET/basketball/api/v2/predictions/

Upcoming ELO predictions sorted by confidence.

POST/basketball/mcp/

JSON-RPC 2.0 MCP endpoint. Drops into Claude, ChatGPT, Gemini. Tools: list_leagues, list_teams, search_teams, list_events, get_event, get_predictions, search_players, get_player, get_box_score, get_team_stats.

Try it

# Upcoming fixtures
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/events/?status=scheduled&limit=10"

# Box score for a finished game
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/events/<event_id>/box-score/"

# Team stats (scoring + rebounds + lead breakdown)
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/events/<event_id>/team-stats/"

# Player search + recent games
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/players/?search=Edwards"
curl -H "Authorization: Token YOUR_KEY" \
  "https://sports.bzzoiro.com/basketball/api/v2/players/<player_id>/games/?limit=10"

# ELO predictions
curl "https://sports.bzzoiro.com/basketball/api/v2/predictions/?limit=20"

MCP server

{
  "mcpServers": {
    "basketball": {
      "url": "https://sports.bzzoiro.com/basketball/mcp/",
      "transport": "streamable-http",
      "headers": { "Authorization": "Token YOUR_KEY" }
    }
  }
}

Tracked leagues

League	Country
NBA	USA
Euroleague	Europe
Liga ACB	Spain
Lega A Basket	Italy
Germany BBL	Germany
Eurocup	Europe