GET /v1/matches/{match_id}/liveThe live score and the whole record behind it, back to 1927. One key, as a stream, a REST API or a webhook.
Frame scores, breaks and dates are real, from our data. The shots on the table are drawn to carry them, and only ever played when they are on.
Pick a question. The code writes itself, runs against the record and draws the answer. One key for every endpoint, the same shapes in every language.
Four things you can make with one key. Each one below is running on real results from this season's finals.
GET /v1/matches/{match_id}/livePOST your endpointcents = api.get_all("/v1/centuries") plot(by_decade(cents))
GET /v1/centuriesmatch.finishedFrom the first world final in 1927 to this week's results, in the same shape. Sign in with Google and make your first call in the time it takes to rack the reds. The free key reads yesterday, today and what is scheduled; the paid plans open the archive.
Continue with GoogleGoogle sign-in only. No password to remember.
Each record is checked against itself and against an independent record of the game. What does not agree is looked at, fixed or explained, in the open.
Every decade of the professional game in one record, and the newest results within minutes: checked every five minutes while an event is on. Choose a decade to see what it holds.
Yes. Sign in with Google and your key is made at once: 50 calls a day, 30 a minute, reading yesterday, today and what is scheduled. The archive back to 1927 is on the paid plans.
Frame scores are checked every five minutes while an event or its qualifying is being played. The stream, the feed and webhooks carry match.started, frame.won, match.finished and century.made.
The stream is Server-Sent Events, for browsers and servers alike, and reconnects from the last event so nothing is missed. Webhooks are on the paid plans: signed POSTs to your endpoint, tried up to 8 times.
To 1927, frame by frame where frames were recorded, which is mostly finals. World rankings come with points, list by list as each season was revised.
No. Snooker API is factual data only: results, draws, frames, players, rankings and breaks.
Yes. There is an MCP server at snookerapi.net/mcp, an agent skill at /skill.md and the whole manual at /documentation/manual.md.
The answer is 429 with Retry-After in seconds. Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, so you can see it coming.
The details are on the terms page.