Base URL
Authentication
Include your API key in thex-api-key header:
Snooker-Specific Notes
Individual Sport
Snooker is a 1v1 individual sport. On the API, “teams” represent individual players (e.g., Ronnie O’Sullivan has ateamId). Use /api/teams/:id to get player profiles.
Match Structure
- Best-of-N frames: All matches are best-of a set number of frames
- Early rounds: Best of 7 or 9
- Semi-finals: Best of 11 or 17
- World Championship Final: Best of 35 (played over 4 sessions across 2 days)
- A frame is one complete game on the table
Scoring
- Red balls: 1 point each (15 reds)
- Colours: Yellow (2), Green (3), Brown (4), Blue (5), Pink (6), Black (7)
- Maximum break: 147 (15 reds + 15 blacks + all colours)
- Century break: 100+ points in one visit — the benchmark of excellence
Key Statistics
- Frames won/lost, century breaks, highest break, maximum 147s
- Frame win percentage, long pot success %, safety success %
Category Structure
Snooker uses a single International category (ID: 55) because the World Snooker Tour is a unified global circuit.Season
August–May, following the World Snooker Tour calendar.Endpoint Categories
| Category | Count | Description |
|---|---|---|
| Live & Schedule | 7 | Live scores, schedules, newly added |
| Search & Discovery | 7 | Search, categories, trending players |
| Tournament | 22 | Standings, brackets, rounds, stats |
| Match | 22 | Scores, statistics, odds, highlights |
| Team / Player Profile | 12 | Player profiles (as “teams”), form |
| Player Stats | 17 | Career stats, season stats, media |
| Referee / Venue | 8 | Referees and venue data |
| Total | 94 |
Example Requests
Major Tournaments
| Tournament | Month | Venue | Format |
|---|---|---|---|
| World Snooker Championship | April-May | The Crucible, Sheffield | Best of 35 (final) |
| UK Championship | November-December | York | Best of 11/19 |
| The Masters | January | Alexandra Palace, London | Invitation-only top 16 |
Key Players (for testing)
| Player | Notable |
|---|---|
| Ronnie O’Sullivan | ”The Rocket” — most centuries in history (1,000+) |
| Judd Trump | World #1 contender |
| Mark Selby | 4× World Champion |
| Ding Junhui | China’s #1, 2025 World Champion |
Sport Comparison — Snooker vs Darts vs Tennis
| Feature | Snooker | Darts | Tennis |
|---|---|---|---|
| Format | Best-of-N frames | Best-of-N sets/legs | Best-of-N sets |
| Scoring unit | Frames won (e.g., 10-7) | Sets/Legs won | Sets/Games won |
| Individual | 1v1 always | 1v1 always | 1v1 or doubles |
| Match length | 30 min – 4 days (World Final) | 30 min – 3 hours | 1-5 hours |
| Points per frame | Up to 147 (maximum break) | 501 per leg | 4 game points |
| Key stat | Century breaks (100+) | 180s (treble-20s) | Aces |
| Season | Aug – May | Jan – Jan | Jan – Nov |
| Venues | The Crucible, Ally Pally | Ally Pally, Lakeside | Grand Slams |
UI Design Ideas
- Frame score: Show frames won: “O’Sullivan 10-7 Trump” with current frame break
- Century counter: Highlight 100+ breaks prominently — prestige stat
- Maximum break: 147 is extremely rare — display with special formatting
- Session tracking: Long matches split across multiple sessions