Skip to city content
CASTER CITYBuild your city

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 }