Documentation / Live
GET /live/eventsFree key, archive on paid
Snooker API: The live feed: every score change, frame won, result and century in the events being played, oldest first after since
The live feed: every score change, frame won, result and century in the events being played, oldest first after since.
GEThttps://api.snookerapi.net/v1/live/events
Try it
Parameters
| Name | Type | What it is |
|---|---|---|
| since | id | The last le_ id you had: the feed carries on after it. Left out, the last hour. |
| match_id | id | Only this match (mt_ id). |
| types | string | Only these event types, comma separated: match.started, frame.won, match.finished, century.made. |
| per_page | integer | Events a call, up to 200. |
Returns
| Field | Type | What it holds |
|---|---|---|
| id | string | The record's own id: stable, and the same in every call. |
| type | string | match.started, frame.won, match.finished or century.made. |
| at | string | When we had it (UTC). |
| event | object | The event: id, name and season. |
| match | object or null | The match: id, stage, round and both players; null for a century. |
| data | object | What changed: the scores and best of, the frames won, the winner, or the century's player and points. |
Example answer
A real answer, read from the data within the last hour: GET /v1/live/events?per_page=3
{
"data": [],
"meta": {
"plan": "House key",
"count": 0,
"next_since": "le_gakwevmj",
"more": false,
"seconds_behind": 2,
"poll_seconds": 300
}
}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 |