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.
If you plan to collect data automatically please contact us so we can agree on what you should put in the header. E.g. "X-Requested-By": "PetersAndroidApp".
Services
- Info (this page)
- Event
- URL format: api.snooker.org/?e=[Event ID]
- Example: api.snooker.org/?e=398 (Shanghai Masters Qualifiers 2015)
- 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)
- 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)
- 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)
- 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)
- Output: Match info as JSON (two-dimensional)
- Ongoing matches (including those between sessions)
- URL format: api.snooker.org/?t=7
- Example: api.snooker.org/?t=7
- Output: Match info as JSON (two-dimensional)
- 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)
- 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)
- Output: Player info as JSON (two-dimensional)
- Players
- URL format: api.snooker.org/?t=10&st=[p|a]&s=[Season]
- Example: api.snooker.org/?t=10&st=p&s=2015 (Pro players in 2015)
- 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
- URL format: api.snooker.org/?t=13&e=[Event ID]
- Example: api.snooker.org/?t=13&e=403 (Shanghai Masters 2015)
- Output: Event seeding as JSON (two-dimensional)
- Upcoming matches
- URL format: api.snooker.org/?t=14
- Example: api.snooker.org/?t=14
- Output: Match info as JSON (two-dimensional)
Known applications
- BlackPocket Snooker (Android app providing live scores, results, a calendar and more)
- 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 tracker (Alexa Skills: Ask for the frame score of current matches)
- World Snooker Online (iOS app providing live scores (with notifications), rankings, results, a calendar and more)
- comperank (Collection of snooker data)
- Snooker calendars (various calendars you can subscribe to)
- @snookerbot (Mastodon)
- Snooker Live (iOS app providing notification from selected matches, and also upcoming matches, live scores, results and rankings)
© 2016-2023 Hermund Årdalen (webmaster@snooker.org)