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: Default status (st) is pro (p). Prior to around 2010/2011 all players are defined as amateurs though.
      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)
21. Ranking points for each player in a Main Tour or Q Tour event (current season)
    • URL format: api.snooker.org/?t=21&e=[Event ID]
    • Example: api.snooker.org/?t=21&e=2337 (Championship League 2025) [static]
    • Output: Player points JSON (two-dimensional)

Known Applications and More

• An alternative rating system for snooker players (ELO-Like system by Robbie Mc Guinness to rank players)
• @amateursnooker.snooker.uk.to.ap.brid.gy (Bluesky, amateur results)
• BP-Live Snooker Score App (Android app providing live scores, results, a calendar and more)
• Ceefax: Latest (webpage recreating the old Ceefax view)
• comperank (Collection of snooker data)
• Fantasy Snooker (Web-based fantasy league for snooker)
• FavSports (Follow your favourite teams and players in different sports, including snooker)
• J-Ratings Snooker (ELO ratings with a chance to compare players and see peaks)
• Laravel PHP Wrapper
• Lik (Android app providing live scores, results, rankings, a calendar and more)
• MaxBreak (Android app providing live scores, results, rankings, a calendar and more)
• Snooker (Clawhub skill for looking up rankings, results, player profiles, live matches and head-to-head records)
• Snooker-ICAL (generates an ICAL file for import into calendar applications; no longer updated)
• SnookerLive ("Make SnookerLive Great Again", Telegram bot for score updates)
• SnookerLive (Telegram bot for score updates; no longer updated)
• SnookerStats (Android app for personal use which displays data from the API in human readable form)
• Snooker Calendar (Web app to track matches and sync them with Google Calendar. See also the source code.)
• Snooker Score Announcer (Website that reads live snooker scores aloud. Primarily for blind and visually impaired viewers but also works for sighted users who want to keep up with the score while doing something else.)
• Snooker calendars (various calendars you can subscribe to)
• Snooker Event Informaton (website in Chinese with scores and results)
• Snooker Fantasy Five (website where you can track your fantasy Five team)
• Snooker Freaks (website with live scores, results and upcoming matches)
• Snooker Live (iPhone app providing notification from selected matches, and also upcoming matches, live scores, results and rankings) *Our official partnered app*
• Snooker predictions (predicting match outcomes based on ELO ratings)
• Snooker Scores (Plugin for TRMNL)
• Snooker Stats (Custom Home Assistant component for gathering data about Snooker matches and players.)
• @snookerbot (Mastodon)
• @snookerbot.snooker.uk.to.ap.brid.gy (Bluesky, pro results)
• Telescore (app recreating the old Ceefax view)
• World Snooker Online (iOS app providing live scores (with notifications), rankings, results, a calendar and more)
• WP Snooker API Plugin (A WordPress plugin that fetches snooker match data)


• "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)
• JSON Content Importer (Using the API as example data for Nested Shortcodes)
• "Social Cues: Why Do So Many Snooker Players Put 147 In Their Handles?" (Article by Thomas Aston on Substack, using the API as data)

© 2016-2026 Hermund Årdalen (webmaster@snooker.org)