Documentation / Yesterday's statistics
Snooker API: Yesterday (UTC) in one answer: matches, walkovers, frames, deciding frames, whitewashes, average match length, centuries and the highest break, in all and by stage
Yesterday (UTC) in one answer: matches, walkovers, frames, deciding frames, whitewashes, average match length, centuries and the highest break, in all and by stage.
GEThttps://api.snookerapi.net/v1/stats/yesterday
Try it
Parameters
| Name | Type | What it is |
|---|---|---|
| event_id | id | Only this event (ev_ id). |
| stage | string | Only the main draw, qualifying or pre-qualifying. main qualifying pre_qualifying |
Returns
| Field | Type | What it holds |
|---|---|---|
| date | date or null | The day it was played or made, when known. |
| events | integer | How many events had a match finish yesterday. |
| players | integer | How many players played a match. |
| matches | integer | How many matches are held. |
| walkovers | integer | Matches given as walkovers: counted apart, never in the frames. |
| frames_played | integer | Frames played, from the match scores, where the score is in frames. |
| deciding_frames | integer | Matches won by one frame at full length. |
| whitewashes | integer | Matches won without losing a frame (longer than best of 3). |
| average_frames | number or null | Frames a match, on average, where the score is in frames. |
| centuries | integer | Century breaks made yesterday, from our live feed. |
| highest_century | integer or null | The highest century made yesterday; null with none. |
| by_stage | object | The same figures for each stage played: main, qualifying, pre_qualifying. |
Example answer
A real answer, read from the data within the last hour: GET /v1/stats/yesterday
{
"data": {
"date": "2026-10-27",
"events": 0,
"players": 0,
"matches": 0,
"walkovers": 0,
"frames_played": 0,
"deciding_frames": 0,
"whitewashes": 0,
"average_frames": null,
"centuries": 0,
"highest_century": null,
"by_stage": {}
},
"meta": {
"plan": "House key",
"date": "2026-10-27",
"note": "No match finished yesterday (2026-10-27, UTC). Days between events have none."
}
}Errors
| Status | Code | When |
|---|---|---|
| 401 | unauthorized | No key, or a key that is not valid. Errors |
| 400 | bad_request | A parameter has the wrong shape. Errors |
| 422 | unknown_parameter | A parameter this call does not take. Errors |
| 429 | rate_limited | Too many calls this minute; wait for Retry-After. Errors |