Match Endpoints

22 endpoints for snooker match data: frame scores, statistics, odds, and highlights

Scoring Format

Snooker is played frame-by-frame. The /scores endpoint returns:

{
  "homeScore": { "period1": 72, "period2": 0, "period3": 85, "current": 5 },
  "awayScore": { "period1": 68, "period2": 91, "period3": 0, "current": 3 }
}

• period1+ = points scored in each frame (0 = lost that frame)
• current = frames won
• Maximum frame score: 147 (maximum break)

Match Endpoints (22)

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

Match Details

GET /api/match/:matchId

Full match details including players, frame scores, tournament context.

Scores

GET /api/match/:matchId/scores

Frame-by-frame scores.

Lineups

GET /api/match/:matchId/lineups

Player details for both sides.

Match Statistics

GET /api/match/:matchId/statistics

Match stats: century breaks, highest break, frame win percentage.

Incidents

GET /api/match/:matchId/incidents

Frame results, breaks, key moments.

Player Statistics

GET /api/match/:matchId/player-statistics
GET /api/match/:matchId/player/:pid/statistics

All player stats or individual player stats in the match.

Best Players & Award

GET /api/match/:matchId/best-players
GET /api/match/:matchId/award

Head-to-Head

GET /api/match/:matchId/h2h

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

Scoring Graph

GET /api/match/:matchId/graph

Scoring progression throughout the match.

Form & Streaks

GET /api/match/:matchId/pregame-form
GET /api/match/:matchId/streaks

Media & Highlights

GET /api/match/:matchId/highlights
GET /api/match/:matchId/media

Fan Predictions

GET /api/match/:matchId/votes

Broadcast Info

GET /api/match/:matchId/channels

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

Odds

GET /api/match/:matchId/odds
GET /api/match/:matchId/odds/all
GET /api/match/:matchId/odds/pre-match
GET /api/match/:matchId/odds/live
GET /api/match/:matchId/winning-odds