snooker.org API
This is the API interface to the snooker.org installation of ScoreKeeper.
If you want to use it you need to have an approved value in the header (X-Requested-By). Please contact us to get such a name.
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
- Info (this page)
- 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)
- 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)
- 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)
- Events in a season
- URL format: api.snooker.org/?t=5(&s=[Season])
- Example: api.snooker.org/?t=5&s=2015 (2015/2016) [static]
- Output: Event info as JSON (two-dimensional)
- Note: All seasons: -1
- 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)
- Ongoing matches (including those between sessions)
- Matches for a player in a season
- URL format: api.snooker.org/?t=8&p=[Player ID](&s=[Season])
- Example: api.snooker.org/?t=8&p=1&s=2015 (Mark J Williams, 2015/2016) [static]
- Output: Match info as JSON (two-dimensional)
- Note: All seasons: -1
- 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)
- 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
- Rankings
- Round info for a season or an event (current season used if both are missing)
- Seeding for an event
- Upcoming matches
- Results from the last few days (default number of days: 0 (today))
- URL format: api.snooker.org/?t=15(&ds=[Number of days])
- Example: api.snooker.org/?t=15&ds=2 (Results from today and the preceding two days) [static]
- Output: Match info as JSON (two-dimensional)
- Note: There is a limit of 500 results returned
- 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])
- Example: api.snooker.org/?p2=5&p1=12&s=2016 (Ronnie O'Sullivan vs Judd Trump, 2016/2017) [static]
- Output: Match info as JSON (two-dimensional)
- Note: All seasons: -1
- Ongoing matches (including those between sessions) plus upcoming or finished matches 60 minutes each way
- Candidates for the upcoming matches of an event
- 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)
- The current season
Known applications
- 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)
- 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)
© 2016-2024 Hermund Årdalen ([email protected])