PUBLIC API

TFCL PLAY API

Read-only JSON endpoints for community sites, bots, and overlays. No authentication required. All responses are cached at the CDN edge for short bursts to keep load minimal.

FULL REFERENCE All 200+ endpoints (auth, lobbies, tournaments, cups, admin, premium) in one browsable OpenAPI 3.0 spec with try-it-out: OPEN /api-docs swagger.yaml

BASE URL

https://play.tfcleague.com

Use the production domain for stable integrations. All endpoints return JSON.

PUBLIC ENDPOINTS

GET /api/public/summary

Public stats summary (matches, lobbies, top ELO, online now).

GET /api/public/lobbies

Active lobbies list (current live/gathering queues).

GET /api/public/leaderboard

Top 50 ELO leaderboard.

GET /api/public/matches?limit=

Recent matches (default 50, max 200).

GET /api/public/match/:id

Match detail + players for a single match.

GET /api/public/changelog?limit=

Changelog entries (default 20, max 100).

NOTES

Responses include Cache-Control headers (30s) for CDN caching.
All endpoints are read-only and safe for public consumption.
Need additional data? Reach out via the TFCL Discord.