Documentation / Live
GET /stream/tokenFree key, archive on paid
Snooker API: A token for the stream, for a browser: EventSource cannot send a header, so it opens /v1/stream?token=... instead of sending the key
A token for the stream, for a browser: EventSource cannot send a header, so it opens /v1/stream?token=... instead of sending the key.
GEThttps://api.snookerapi.net/v1/stream/token
Try it
Returns
| Field | Type | What it holds |
|---|---|---|
| token | string | The stream token: open /v1/stream?token=... with it. |
| expires_at | string | When the token stops working (UTC). |
| url | string | The stream address with the token, ready for EventSource. |
Example answer
A real answer, read from the data within the last hour: GET /v1/stream/token
{
"data": {
"token": "st_MmdzZjVoZ3MuMTc5MzIyMjQwNS5iYWFlMjg2ZGE4MThlMzI4MTU3NzUzZjliYWIzYzgwNw",
"expires_at": "2026-10-28T21:20:05Z",
"url": "https://api.snookerapi.net/v1/stream?token=st_MmdzZjVoZ3MuMTc5MzIyMjQwNS5iYWFlMjg2ZGE4MThlMzI4MTU3NzUzZjliYWIzYzgwNw"
},
"meta": {
"plan": "House key"
}
}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 |