Build on tourna.gg

A read-only API for the data tourna.gg already shows publicly: events, players, matches, standings and leaderboards. Apply for a key, and once it is approved you can start making requests.

Apply for API access API terms

How it works

Sign in and apply. Tell us what you are building and what you will use the data for.
We review each application and reply by email. A rejection includes the reason.
Once approved, create up to three keys on your keys page. A key is shown once, so copy it then.
Send it on every request as Authorization: Bearer <key>.

First request

curl https://www.tourna.gg/api/v1/public/events?when=upcoming&limit=5 \
  -H "Authorization: Bearer tg_..."

Every successful response is { "data": ... }. Every error is { "error": { "code", "message" } }. Names are snake_case.

Endpoints

All are GET requests under https://www.tourna.gg/api/v1/public.

/events: Public events. Filter with when, game, tier, country, state, q and limit.
/events/{id}: One event: game, tier, status, format, venue and date.
/events/{id}/players: Who is entered: name, seed, checked in or dropped.
/events/{id}/matches: Every round, first stage and top cut, with each match and its scores.
/events/{id}/standings: Ranked standings with the event's tiebreakers applied.
/leaderboards: The public leaderboards. Choose game, scope (season or all_time) and limit.

Limits and errors

A new key is limited to 5,000 requests a day, counted from 00:00 UTC. Each response carries X-RateLimit-Limit and X-RateLimit-Remaining.
401 the key is missing, wrong or revoked. 403 the owning account is suspended. 404 no such event, or it is not public. 429 the daily limit is used up.
Private events, accounts and contact details are never available through the API.