Documentation / Events
Snooker API: The world ranking points each player earned at a ranking event, as the season's rankings publish them, and whether our own results for the event give the same points
The world ranking points each player earned at a ranking event, as the season's rankings publish them, and whether our own results for the event give the same points.
GEThttps://api.snookerapi.net/v1/events/{event_id}/points
Try it
Parameters
| Name | Type | What it is |
|---|---|---|
| event_id | id, required, in the path | The event, as an ev_ id from GET /v1/events. |
| 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. |
| points | integer or null | Ranking points, or the break's points. |
| rebuilt_points | integer | The points our own results for the event give the player: the points for the round he went out in. |
| agrees | boolean | Whether the published points and the points rebuilt from our results are the same. |
Example answer
A real answer, read from the data within the last hour: GET /v1/events/ev_gceh5m87/points?per_page=5
{
"data": [
{
"player": {
"id": "pl_7g8hbdzt",
"name": "Mark Selby"
},
"points": 500000,
"rebuilt_points": 500000,
"agrees": true
},
{
"player": {
"id": "pl_w2c64qam",
"name": "Shaun Murphy"
},
"points": 200000,
"rebuilt_points": 200000,
"agrees": true
},
{
"player": {
"id": "pl_wy3wkk0f",
"name": "Kyren Wilson"
},
"points": 100000,
"rebuilt_points": 100000,
"agrees": true
},
{
"player": {
"id": "pl_0gdn9s91",
"name": "Stuart Bingham"
},
"points": 100000,
"rebuilt_points": 100000,
"agrees": true
},
{
"player": {
"id": "pl_0cxvrznr",
"name": "Anthony McGill"
},
"points": 50000,
"rebuilt_points": 50000,
"agrees": true
}
],
"meta": {
"plan": "House key",
"count": 5,
"next_cursor": "bzUuOGY5NjNi",
"page": 1,
"per_page": 5,
"total": 110,
"total_pages": 22,
"next_page": 2,
"prev_page": null,
"event": {
"id": "ev_gceh5m87",
"name": "2021 World Snooker Championship",
"season": "2020-21"
},
"players_agree": "110 of 110"
}
}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 |