Players
Search and list, with accents and particles folded.
Free key7 days behind
Livelast 30 days
Archive and upwhole archive
Cursor or page
Parameters
All optional, all in the query stringqstringSearch text. Accents and particles are folded, so "van gerwen" finds Michael van Gerwen.
country_codestringAn ISO 3166 country code, lower case, such as nl or de; the home nations are gb-eng, gb-sct, gb-wls and gb-nir.
activebooltrue for players who played this year or last; false for the rest.
limitintHow many to return. Default 50, at most 200.
cursorcursorCarry on from here: pass back meta.next_cursor exactly as it came.
Try it
Your key, sent from your browser straight to the APIPaste your keyGet a free one in a minute
Run it to see your limits
What comes back
Each item in data, read from a real response| Field | Type | Example |
|---|---|---|
player_id | id | "pl_60FSJP" |
name | string | "Keenan Littler" |
country_code | string | "za" |
first_year | number | 2023 |
last_year | number | 2025 |
matches | number | 37 |
meta.next_cursor | string | Pass back as cursor for the next page; null on the last |
When it refuses
Every error code| Status | Code | When |
|---|---|---|
| 401 | no_key | No key, a malformed key, or one that is not ours. |
| 422 | bad_parameter | A parameter is malformed or out of range, named in the message. |
| 429 | rate_limited | Over your rate or allowance. Retry-After says when. |