Skip to main content

Scoring Format

Snooker is played frame-by-frame. Frame-by-frame scores are embedded directly in the Match Details payload (GET /api/match/:matchId) and in the live feeds (GET /api/live, GET /api/live/all) — snooker does not expose a dedicated /scores sub-endpoint. The scores block looks like:
  • period1+ = points scored in each frame (0 = lost that frame)
  • current = frames won
  • Maximum frame score: 147 (maximum break)

Upstream Limitations

The following sub-endpoints are not available for snooker — the upstream data provider does not publish them for this sport. Requests will return an empty or not-found response:
  • GET /api/match/:matchId/scores — use /api/match/:matchId (Match Details) or /api/live instead
  • GET /api/match/:matchId/lineups
  • GET /api/match/:matchId/statistics
  • GET /api/match/:matchId/incidents
  • GET /api/match/:matchId/graph
This is a permanent limitation of snooker coverage, not a bug.

Match Endpoints (17)

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

Match Details

Full match details including players, frame-by-frame scores, and tournament context.

Player Statistics

All player stats or individual player stats in the match.

Best Players & Award

Head-to-Head

Historical head-to-head record between the two players.

Form & Streaks

Media & Highlights

Fan Predictions

Broadcast Info

TV broadcast info (BBC, Eurosport, etc.).

Odds

Last modified on July 8, 2026