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

# Live, Schedule & Search Endpoints

> Snooker V2 live scores, schedules, search, and discovery

## Live & Schedule Endpoints (7)

All endpoints use base URL `https://api.sportsapipro.com/v2/snooker`.

```bash theme={null}
GET /api/live                           # Curated live matches (player names, frame scores)
GET /api/live/all                       # Raw live data
GET /api/today                          # Today's scheduled matches
GET /api/schedule/:date                 # Schedule by date (YYYY-MM-DD)
GET /api/live-tournaments               # Tournaments with live matches
GET /api/scheduled-tournaments/:date    # Tournaments with matches on date
GET /api/newly-added-events             # Recently added matches
```

### Response Example — `/api/live`

```json theme={null}
{
  "events": [
    {
      "id": 12345678,
      "homeTeam": { "id": 6801, "name": "Ronnie O'Sullivan" },
      "awayTeam": { "id": 6802, "name": "Judd Trump" },
      "homeScore": {
        "current": 5,
        "display": 5,
        "period1": 72,
        "period2": 0,
        "period3": 85,
        "period4": 63
      },
      "awayScore": {
        "current": 3,
        "display": 3,
        "period1": 68,
        "period2": 91,
        "period3": 0,
        "period4": 70
      },
      "status": { "code": 19, "description": "9th Frame", "type": "inprogress" },
      "tournament": { "name": "World Snooker Championship", "id": 200 },
      "startTimestamp": 1737331200
    }
  ]
}
```

### Score Fields

| Field      | Description                           |
| ---------- | ------------------------------------- |
| `period1`+ | Points scored in each frame (max 147) |
| `current`  | Frames won                            |

<Note>Snooker frame scores show individual frame point totals. A century break (100+) is considered a milestone achievement. Maximum break is 147.</Note>

## Search & Discovery Endpoints (7)

```bash theme={null}
GET /api/search?q=ronnie               # Search players, tournaments
GET /api/countries                      # Categories (International)
GET /api/countries/all                  # Extended categories
GET /api/categories/:categoryId/tournaments  # Tournaments in category
GET /api/trending-players               # Trending snooker players
GET /api/news?lang=en                   # Snooker news
GET /api/country/:code/flag             # Country flag URL
```

### Example: Find Live Matches

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

### Example: Browse All Snooker Tournaments

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

<Note>Snooker uses a single International category (ID: 55) — all World Snooker Tour ranking events fall under this one category.</Note>