SnookerAPI
Documentation / Guides

Snooker API quick start

Quick start

A key, the first call and the answer, in three steps.

1. Get a free key from your account at snookerapi.net. It starts snk_live_ and is shown once: keep it somewhere safe.

2. Ask for something with the key in a header. The newest World Championship final:

curl -H "Authorization: Bearer $SNOOKER_KEY" "https://api.snookerapi.net/v1/matches?event_id=ev_80r2d1px&round=final"

3. Read the answer. Every answer is data (a record or a list) and meta (your plan, the counts and the next page). Ids such as mt_fse5w2by link records together: open the match with GET /v1/matches/{match_id} to see its frames.

Next: Authentication, Pagination and Errors.