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.

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.