Developers
Caster City public API
Read-only, no-auth JSON endpoints for Caster City game data. Rate limited to 30 requests per minute per IP, and CORS-enabled for use from any origin.
GET /api/public/leaderboard
Top 20 cities ranked by clout, globally. Rows are ordered highest clout first.
{
"rows": [
{ "fid": 1234, "username": "alice", "city_name": "Alice City", "clout": 98200 }
]
}GET /api/public/cup
Current weekly Cup bracket, entries, champion, and reward info.
{
"entries": [{ "seed": 1, "fid": 1234, "power": 5200, "city_name": "Alice City", "username": "alice" }],
"champion": { "week_start": "2026-09-08", "winner_fid": 1234, "champion_power": 5200 },
"closesAt": "2026-09-15T00:00:00.000Z",
"capacity": 32,
"rewards": { "cityCoins": 1000, "xp": 1000, "badge": "Champion", "card": "Legendary", "trophy": "Permanent" }
}GET /api/leaderboard
Full leaderboard used by the app UI. Query params: scope=global|weekly|friends, metric=clout|wins|population|streak|activity|growth, fid=<required for friends scope>.
{
"rows": [{ "rank": 1, "fid": 1234, "clout": 98200 }],
"metric": "clout",
"scope": "global",
"description": "Current saved city totals."
}GET /api/cup
Same data as /api/public/cup, used internally by the app UI.
{ "entries": [], "champion": null, "capacity": 32 }