Live frame scores, within minutes of each frame

Snooker Data API

Every frame of every final, as it lands

The live score and the whole record behind it, back to 1927. One key, as a stream, a REST API or a webhook.

Kyren Wilson0
0 - 0Frame 1 · best of 19
John Higgins0
Break0
waiting
Replay2026 International Championship final7 November 2026
request
GET /v1/stream · text/event-stream

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.

What is in the dataNearly a century of professional snooker, read, checked and kept current every day
✓15 of 21 integrity checks clear
Matches and centuries by decadeMatchesCenturies
76,484matches56,041 main draw · 20,336 qualifying
1,255events236 competitions, 1927 to 2026
4,483players2,799 with a nationality · 1,211 with a birth date
28,140century breaksfrom 1935 · 246 official maximums
Dataset and what it coversRecordsSinceExample callActions
Build with itAsk anything of 99 years of snooker, in a few lines of code

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.

0matches
0frames scored
0century breaks
0players
0ranking places
0events
Same key, every endpointGET unless marked
Ready
What people buildFrom a scoreboard on your site to a bot in your group chat

Four things you can make with one key. Each one below is running on real results from this season's finals.

Northern Ireland Open finalLive
Kyren Wilson0
Jak Jones0
Best of 17
A scoreboard on your siteDrop the live score into any page. It updates itself within minutes of each frame.GET /v1/matches/{match_id}/live
S#snooker-resultswebhook
Alerts in your group chatEvery frame, every century, every result, posted to you as soon as we have it.POST your endpoint
In [1]
cents = api.get_all("/v1/centuries")
plot(by_decade(cents))
Research and analysisNearly a century of results in one shape, ready for a notebook or a spreadsheet.GET /v1/centuries
Who wins the final?
Pick'em gamesLock picks before the match, settle them on the result. No manual marking.match.finished
Start nowNearly a century of snooker. One key.

From 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 Google

Google sign-in only. No password to remember.

  • Every endpoint on one key
  • REST, stream and webhooks
  • Records back to 1927
your terminal
0matches
0century breaks
0official maximums
1927the first final on record
Checked, not just collectedEvery figure is tested before you call it

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.

0%of match scores agree with an independent record36,819 matches compared
0%of top-64 ranking places agree2,496 places, 1977 to 2020
0%of matches placed within the days they were played76,484 matches
Integrity runRunning
0 of 21 checks
The record, decade by decadeFrom the first world final in 1927 to this morning

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.

MatchesCentury breaks
Now: checked every five minutes while an event is on
2020s
QuestionsWhat people ask before their first call

Short answers. The documentation has the long ones.

Is there a free key?

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.

How live is live?

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.

Stream or webhooks?

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.

How far back does it go?

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.

Does it include betting odds or predictions?

No. Snooker API is factual data only: results, draws, frames, players, rankings and breaks.

Can I use it from an assistant?

Yes. There is an MCP server at snookerapi.net/mcp, an agent skill at /skill.md and the whole manual at /documentation/manual.md.

What happens when I hit a limit?

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.

Who runs it?

The details are on the terms page.