🎾 Tennis API Documentation

The Tennis API provides read-only access to tennis data including tournaments, players, matches, live scores, ML predictions, and ATP/WTA rankings. All responses are JSON.

Every API request requires a token. Get yours by registering a free account on sports.bzzoiro.com.

Include the token in the Authorization header:

Authorization: Token YOUR_API_KEY

Example:

curl -H "Authorization: Token abc123def456" https://tennis.bzzoiro.com/api/tournaments/

All list endpoints return paginated results with 50 items per page.

{
  "count": 120,
  "next": "https://tennis.bzzoiro.com/api/matches/?page=2",
  "previous": null,
  "results": [ ... ]
}

Use ?page=N to navigate pages.

1. Register: Create a free account at sports.bzzoiro.com/register/
2. Get your token: After registering you'll find your API token on your dashboard. The same token works across all platforms.
3. Make a request:

   curl -H "Authorization: Token YOUR_API_KEY" https://tennis.bzzoiro.com/api/tournaments/

4. Explore: Use the endpoints above to fetch players, matches, live scores, predictions, and rankings.

import requests

API_TOKEN = "YOUR_API_KEY"
BASE_URL = "https://tennis.bzzoiro.com/api"
headers = {"Authorization": f"Token {API_TOKEN}"}

# Get upcoming predictions
resp = requests.get(f"{BASE_URL}/predictions/", headers=headers)
data = resp.json()

for pred in data["results"]:
    match = pred["match"]
    print(f"{match['player1']} vs {match['player2']}")
    print(f"  Winner: Player {pred['predicted_winner']} "
          f"(P1: {pred['prob_player1_wins']:.1f}% "
          f"P2: {pred['prob_player2_wins']:.1f}%)")
    print(f"  Confidence: {pred['confidence']:.1f}%")
    print(f"  Expected sets: {pred['expected_total_sets']:.1f}")
    print()

# Get live scores
live = requests.get(f"{BASE_URL}/live/", headers=headers).json()
for match in live["results"]:
    print(f"LIVE Set {match['current_set']} "
          f"{match['player1']} {match['player1_sets']}-"
          f"{match['player2_sets']} {match['player2']}")

# Get ATP top 10
rankings = requests.get(
    f"{BASE_URL}/rankings/?type=ATP&top=10",
    headers=headers
).json()
for r in rankings["results"]:
    print(f"#{r['ranking']} {r['player']['name']} - {r['points']} pts")