BSD · API Documentation

API Documentation.

Pick a sport to get started. All sports share the same authentication and pagination conventions — learn once, use everywhere.

Authentication — same for every sport

Every request needs your API key in the Authorization header. Get a key by registering at sports.bzzoiro.com/register/ → go to your account → copy API key.

# Add this header to every request Authorization: Token YOUR_API_KEY # Example with curl curl -H "Authorization: Token YOUR_API_KEY" \ "https://sports.bzzoiro.com/tennis/api/v2/matches/live/" # Example with Python import requests headers = {"Authorization": "Token YOUR_API_KEY"} r = requests.get("https://sports.bzzoiro.com/tennis/api/v2/matches/live/", headers=headers) print(r.json())

Choose a sport

⚽

Football

Match data, live scores, standings, ML predictions, xG shotmaps and odds for 30+ leagues.

Free View Docs →

🎾

Tennis

ATP/WTA matches, tournaments, players, rankings, set-by-set scores and ML predictions.

Pro $5/mo View Docs →

🎮

CS2 / Esports

CS2 matches with map-by-map scores, team stats, player KD ratios and ML predictions.

Pro $5/mo View Docs →

🎯

Darts

PDC matches, player rankings, tournament results and ELO-based ML win predictions.

Pro $5/mo View Docs →

🏒

Hockey

NHL and international hockey — period scores, overtime/shootout flags and predictions.

Pro $5/mo View Docs →

⚡

Live WebSocket

Real-time ball positions, live scores, momentum counters and odds via WebSocket stream.

Addon $3/mo /docs/websocket/

🤖

MCP — AI Agents

Use sports data inside Claude Desktop, ChatGPT or any MCP-compatible AI agent.

Pro $5/mo /docs/mcp/

📊

Odds API

Per-bookmaker odds for 12+ sports — football, tennis, basketball, NHL, MLB, darts, CS2 and more. Linked to BSD master data.

Addon $5/mo /odds/api/

Common conventions

These rules apply to every sport API — you only need to learn them once.

Pagination

All list endpoints return paginated results. Use limit (page size, default 50, max 200) and offset (how many items to skip, default 0) to page through results.

# First page: items 1–50 GET /tennis/api/v2/matches/?limit=50&offset=0 # Second page: items 51–100 GET /tennis/api/v2/matches/?limit=50&offset=50 # Response shape { "count": 408, // total number of items "next": "https://...", // URL to next page (null if last page) "previous": null, // URL to previous page "results": [...] // items for this page }

Dates and times

All dates and times are in ISO 8601 format, UTC timezone. For example: 2026-06-06T14:00:00+00:00. When filtering by date, pass dates as YYYY-MM-DD.

Match status values

Every sport uses the same three primary status values:

Status	Meaning
`upcoming`	Match hasn't started yet
`live`	Match is currently in progress
`finished`	Match has ended and results are final
`cancelled`	Match was called off before it started
`postponed`	Match rescheduled to a future date

Odds

All odds are decimal format (e.g. 1.85). A value of null means no odds are available for that market yet.

HTTP status codes

Code	Meaning
`200`	Success
`401`	Missing or invalid API token
`403`	Your account doesn't have access to this sport (Pro required)
`404`	The requested item doesn't exist
`429`	Rate limit exceeded — slow down