Documentation / Bulk export
GET /export/{part}Paid plans
Snooker API: Bulk export: one part of the whole record as a gzip file of JSON lines, one record a line, in the same shape as the API, rebuilt daily
Bulk export: one part of the whole record as a gzip file of JSON lines, one record a line, in the same shape as the API, rebuilt daily.
GEThttps://api.snookerapi.net/v1/export/{part}
Try it
Parameters
| Name | Type | What it is |
|---|---|---|
| part | id, required, in the path | events, matches, frames, players, centuries, rankings, maximums or prizes. |
Returns
| Field | Type | What it holds |
|---|---|---|
| part | ||
| rows | ||
| built_at |
Example answer
A real answer, read from the data within the last hour: GET /v1/export/matches
{
"file": "snookerapi-matches-20261028.jsonl.gz",
"content_type": "application/gzip",
"parts": [
"events",
"matches",
"frames",
"players",
"centuries",
"rankings",
"maximums",
"prizes"
],
"one_line": {
"id": "mt_fse5w2by",
"round": "final",
"...": "..."
}
}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 |
| 404 | not_found | No record has that id. Errors |