Live & Schedule Endpoints (7)
All endpoints use base URL https://api.sportsapipro.com/v2/snooker.
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
{
"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 |
Snooker frame scores show individual frame point totals. A century break (100+) is considered a milestone achievement. Maximum break is 147.
Search & Discovery Endpoints (7)
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
curl -H "x-api-key: YOUR_API_KEY" \
https://api.sportsapipro.com/v2/snooker/live
Example: Browse All Snooker Tournaments
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.sportsapipro.com/v2/snooker/categories/55/tournaments"
Snooker uses a single International category (ID: 55) — all World Snooker Tour ranking events fall under this one category.
