Documentation / Yesterday's statistics
Snooker API: Every player who played yesterday: matches won and lost, frames won and lost, frame difference and frame win rate, centuries and their highest. Most wins first
Every player who played yesterday: matches won and lost, frames won and lost, frame difference and frame win rate, centuries and their highest. Most wins first.
GEThttps://api.snookerapi.net/v1/stats/yesterday/players
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 |
| page | integer | Page number, from 1. |
| cursor | string | The next_cursor from the previous page. |
| per_page | integer | Rows per page. |
Returns
| Field | Type | What it holds |
|---|---|---|
| player | object | The player: id and name. |
| nation | string or null | The nation the player plays for, as the draws flag it (ENG, CHN, WAL ...); null where we do not hold it. |
| played | integer | Matches played (walkovers left out). |
| won | integer | Matches won. |
| lost | integer | Matches lost. |
| drawn | integer | Matches drawn: level at the end of a group or league match, where the format allows it. |
| frames_for | integer | Frames won, where the score is in frames. |
| frames_against | integer | Frames lost, where the score is in frames. |
| frame_difference | integer | frames_for less frames_against. |
| frame_win_rate | number or null | Share of frames won, 0 to 1. |
| centuries | integer | Century breaks made yesterday, from our live feed. |
| highest_century | integer or null | The highest century made yesterday; null with none. |
Example answer
A real answer, read from the data within the last hour: GET /v1/stats/yesterday/players
{
"data": [],
"meta": {
"plan": "House key",
"count": 0,
"next_cursor": null,
"page": 1,
"per_page": 50,
"total": 0,
"total_pages": 1,
"next_page": null,
"prev_page": null,
"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 |