snooker.org API

This is the API interface to the snooker.org installation of ScoreKeeper.

It is free for non-commercial use as long as you mention the original source. Please contact us if you want to use it commercially.

Services

1. Info (this page)
   • URL format: api.snooker.org
   • Example: api.snooker.org
   • Output: HTML
2. Event
   • URL format: api.snooker.org/?e=[Event ID]
   • Example: api.snooker.org/?e=398 (Shanghai Masters Qualifiers 2015) [static]
   • Output: Event info as JSON (one-dimensional)
3. Match
   • URL format: api.snooker.org/?e=[Event ID]&r=[Round ID]&n=[Match number]
   • Example: api.snooker.org/?e=397&r=1&n=5 (Riga Open 2015, qual round 1, Mulholland v Arpat) [static]
   • Output: Match info as JSON (one-dimensional)
4. Player
   • URL format: api.snooker.org/?p=[Player ID]
   • Example: api.snooker.org/?p=1 (Mark J Williams) [static]
   • Output: Player info as JSON (one-dimensional)
5. Events in a season
   • URL format: api.snooker.org/?t=5(&s=[Season])(&tr=[Tour])
   • Example: api.snooker.org/?t=5&s=2015&tr=main (2015/2016, Main Tour) [static]
   • Output: Event info as JSON (two-dimensional)
   • Note: All seasons: -1
6. Matches of an event
   • URL format: api.snooker.org/?t=6&e=[Event ID]
   • Example: api.snooker.org/?t=6&e=398 (Shanghai Masters qualifiers) [static]
   • Output: Match info as JSON (two-dimensional)
7. Ongoing matches (including those between sessions)
   • URL format: api.snooker.org/?t=7(&tr=[Tour]) [static]
   • Example: api.snooker.org/?t=7&tr=main
   • Output: Match info as JSON (two-dimensional)
8. Matches for a player in a season
   • URL format: api.snooker.org/?t=8&p=[Player ID](&s=[Season])(&tr=[Tour])
   • Example: api.snooker.org/?t=8&p=605&s=2024&tr=q (Steven Hallworth, 2024/2025, Q Tour) [static]
   • Output: Match info as JSON (two-dimensional)
   • Note: All seasons: -1
9. Players in an event
   • URL format: api.snooker.org/?t=9&e=[Event ID]
   • Example: api.snooker.org/?t=9&e=403 (Shanghai Masters 2015) [static]
   • Output: Player info as JSON (two-dimensional)
10. Players
    • URL format: api.snooker.org/?t=10(&st=[p|a])&s=[Season](&se=[m|f])
    • Example: api.snooker.org/?t=10&st=p&s=2022&se=f (Pro female players in 2022/2023) [static]
    • Output: Player info as JSON (two-dimensional)
    • Note: All seasons: -1
11. Rankings
    • URL format: api.snooker.org/?rt=[Ranking type]&s=[Season]
    • Example: api.snooker.org/?rt=MoneyRankings&s=2015 (Money rankings, 2015) [static]
    • Output: Ranking list as JSON (two-dimensional)
    • Note: Available ranking types
12. Round info for a season or an event (current season used if both are missing)
    • URL format: api.snooker.org/?t=12(&e=[Event ID]|&s=[Season])
    • Examples: api.snooker.org/?t=12&s=2017 (The 2017/2018 season); api.snooker.org/?t=12&e=403 (Shanghai Masters 2015) [static: 1; 2]
    • Output: Round info as JSON (two-dimensional)
13. Seeding for an event
    • URL format: api.snooker.org/?t=13&e=[Event ID]
    • Example: api.snooker.org/?t=13&e=403 (Shanghai Masters 2015) [static]
    • Output: Event seeding as JSON (two-dimensional)
14. Upcoming matches
    • URL format: api.snooker.org/?t=14(&tr=[Tour]) [static]
    • Example: api.snooker.org/?t=14&tr=main (Main Tour)
    • Output: Match info as JSON (two-dimensional)
15. Results from the last few days (default number of days: 0 (today))
    • URL format: api.snooker.org/?t=15(&ds=[Number of days])(&tr=[Tour]) [static]
    • Example: api.snooker.org/?t=15&ds=2&tr=main (Results from today and the preceding two days, Main Tour)
    • Output: Match info as JSON (two-dimensional)
    • Note: There is a limit of 500 results returned
16. Head to head (current season if no season provided)
    • URL format: api.snooker.org/?p1=[ID of player 1]&p2=[ID of player 2](&s=[Season])(&tr=[Tour])
    • Example: api.snooker.org/?p2=5&p1=12&s=2016&tr=main (Ronnie O'Sullivan vs Judd Trump, 2016/2017, Main Tour) [static]
    • Output: Match info as JSON (two-dimensional)
    • Note: All seasons: -1
17. Ongoing matches (including those between sessions) plus upcoming or finished matches 60 minutes each way
    • URL format: api.snooker.org/?t=17(&tr=[Tour]) [static]
    • Example: api.snooker.org/?t=17&tr=main (Main Tour)
    • Output: Match info as JSON (two-dimensional)
18. Candidates for the upcoming matches of an event
    • URL format: api.snooker.org/?t=18&e=[Event ID]
    • Example: api.snooker.org/?t=18&e=1454 (Masters 2023) [static]
    • Output: Candidate info as JSON (two-dimensional)
19. The finals for an event (for all available seasons)
    • URL format: api.snooker.org/?t=19&e=[Event ID]
    • Example: api.snooker.org/?t=19&e=1460 (World Championship 2024) [static]
    • Output: Match info for finals as JSON (two-dimensional)
20. The current season
    • URL format: api.snooker.org/?t=20
    • Example: api.snooker.org/?t=20 [static]
    • Output: Current season as JSON (one-dimensional)

Known Applications

• Ceefax: Latest (webpage recreating the old Ceefax view)
• BlackPocket Snooker (Android app providing live scores, results, a calendar and more)
• comperank (Collection of snooker data)
• Fantasy Snooker (Web-based fantasy league for snooker)
• Lik (Android app providing live scores, results, rankings, a calendar and more)
• Snooker-ICAL (generates an ICAL file for import into calendar applications)
• SnookerLive (Telegram bot for score updates)
• SnookerStats (Android app for personal use which displays data from the API in human readable form)
• Snooker calendars (various calendars you can subscribe to)
• Snooker Event Informaton (website in Chinese with scores And results)
• Snooker Live (iPhone app providing notification from selected matches, and also upcoming matches, live scores, results and rankings) *Our official partnered app*
• Snooker tracker (Alexa Skills: Ask for the frame score of current matches)
• @snookerbot (Mastodon)
• @snookerbot.snooker.uk.to.ap.brid.gy (Bluesky)
• World Snooker Online (iOS app providing live scores (with notifications), rankings, results, a calendar and more)
• An alternative rating system for snooker players (ELO-Like system by Robbie Mc Guinness to rank players)
• "Asynchronous Programming in Java (Callable, Future, CompletableFuture and more)" (Article in Medium, using the API as example data)
• "Cue the maths: predicting snooker's next champion with Elo" (Article in Analysis Paralysis, using the API as data)

© 2016-2025 Hermund Årdalen ([email protected])