> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snooker V2 API Overview

> 94 endpoints for comprehensive snooker data: World Championship, UK Championship, Masters, and the full World Snooker Tour

## Base URL

```
https://api.sportsapipro.com/v2/snooker
```

## Authentication

Include your API key in the `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/snooker/live
```

## Snooker-Specific Notes

### Individual Sport

Snooker is a 1v1 individual sport. On the API, **"teams" represent individual players** (e.g., Ronnie O'Sullivan has a `teamId`). 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

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    https://api.sportsapipro.com/v2/snooker/live
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/snooker/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/snooker/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## 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