API reference
Every read-only JSON endpoint of forts-tools.com: parameters, response fields, statuses, caching and rate limits.
Changed in v2: POST /api/telemetry forts-telemetry/2
POST /api/telemetry now answers a ranked log of any size, in pages. Its schema is forts-telemetry/2; it was forts-telemetry/1.
| What changed | In v1 a log with more matches than one answer holds was refused with 422. In v2 it is answered in full, over several pages. New fields: page, pages, next_url, samples.matches[].continued. |
|---|
| What a v1 client must do | Accept forts-telemetry/2. While page is less than pages, fetch next_url with GET; stop when page equals pages (next_url is then null). Join the pages as below. A client that reads only the first answer gets only page 1 of a long log. |
|---|
| Unchanged | A log of 300 or fewer matches (with ?samples=1, also 6,000 or fewer series points) is answered exactly as in v1 apart from the tag: one page, page: 1, pages: 1, next_url: null. |
|---|
| Further pages | /api/telemetry/<job>/<page>, by GET: pages 2 to pages, the same shape as page 1. Nothing is uploaded or decoded again. |
|---|
| Page size | 300 matches; with ?samples=1, also at most 6,000 series points. |
|---|
| Result lifetime | 10 min from the first answer, the same as downloads[].url. After that a page answers 410; upload the log again. |
|---|
| Joining the pages | matches: pages 1 to pages in order, concatenated. samples.matches: the same, except that an entry marked continued: true goes on in the first entry of the next page; append that entry's rows to it. summary, releases, matches_total, rejections, downloads are the same on every page. |
|---|
| Page statuses | 200: the page. 404: no such page number. 410: the result has expired. 429: the rate limit, shared with the upload, is spent. |
|---|
Endpoints
Rules for every endpoint
| Body | UTF-8 JSON, one object, keys sorted. Times are UTC, written YYYY-MM-DDTHH:MM:SSZ. SteamIDs are 17-digit strings. |
|---|
| Versioning | Every answer carries schema. Its number moves only on a breaking change; a new field is added without changing it, so a client ignores keys it does not know. |
|---|
| Missing values | null means the site holds no value; it is never a measured zero. When an answer is empty or partial, reason says why in English. |
|---|
| Refusals | A refusal by the application is {"ok": false, "error": "…"}, the message in the language of Accept-Language. A refusal by the proxy (429 from a rate limit) is an HTML page with Retry-After. |
|---|
| Browser access | No CORS headers are sent. fetch() from a page is blocked by the browser before the body is readable. Call this endpoint server-side. |
|---|
| Names | Field names, type names and token values are fixed. They are not translated. |
|---|
/api/site
The site summary: live game release, seasons held, board sizes and the endpoints that are on.
| Request | GET https://forts-tools.com/api/site |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-site/1 |
|---|
| Same data as | /about |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
No parameters.
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
documentation | string | false | This reference page. |
|---|
live_release | string | true | The live game release. |
|---|
current_season | integer | true | The season the live board is in. |
|---|
seasons | array<integer> | true | Every season the site holds, newest first. |
|---|
standings_captured_utc | string | true | When the newest standings were read from the game. |
|---|
boards | object | true | The current boards; null while the ladder is off or cannot be read. |
|---|
boards.{board} | object | false | One board, keyed by its board key (for example 1v1). |
|---|
boards.{board}.display | string | false | Board name as the game shows it. |
|---|
boards.{board}.total | integer | false | Accounts on the whole board. |
|---|
endpoints | array<string> | false | The read-only JSON endpoints that are on, sorted. |
|---|
standby | object | false | Coarse state of the site's standby data path. |
|---|
standby.state | string | false | A state token: idle, active-failover or unknown. |
|---|
standby.signal_age_s | integer | true | Seconds since the standby path last checked in. |
|---|
reason | string | true | Why the answer is empty or partial, in English; null when it is complete. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. A store that cannot be read leaves its fields null and is named in reason. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Read on every request. standings_captured_utc is the time of the newest standings capture. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/site
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"boards": {
"1v1": {
"display": "Season 44 Multiplayer 1v1",
"total": 3490
}
},
"current_season": 44,
"documentation": "https://forts-tools.com/api",
"endpoints": [
"/api/builds",
"/api/data",
"/api/live"
],
"live_release": "Forts 1.39.0 (r22875)",
"reason": null,
"schema": "forts-site/1",
"seasons": [
44,
43,
42
],
"source": "https://forts-tools.com/",
"standby": {
"signal_age_s": 94,
"state": "idle"
},
"standings_captured_utc": "2026-11-16T23:35:11Z"
}
/api/rankings
The ranked standings the leaderboard page shows, per board, with each row's recent form and record.
| Request | GET https://forts-tools.com/api/rankings |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-rankings/1 |
|---|
| Same data as | /leaderboard |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
| Name | In | Type | Required | Notes |
|---|
season | query | integer | optional | Season number. Absent: the current season. A season the site holds no data for, or anything but 1 to 3 digits: 404. |
|---|
mode | query | string | optional | One board key, for example 1v1. Absent: every board. Letters, digits, - and _ only, at most 16 characters, else 400; an unknown board: 404. |
|---|
limit | query | integer | optional | Rows per board, 1 to 20; default 20, the page's own top rows. Out of range or not a number: 400. |
|---|
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
definition | string | false | What the figures mean, in English. |
|---|
season | integer | true | Season number. |
|---|
current_season | integer | true | The season the live board is in. |
|---|
seasons | array<integer> | false | Every season the site holds, newest first. |
|---|
archived | boolean | false | True when the answer is a closed season. |
|---|
captured_utc | string | true | When the standings were read from the game. |
|---|
read_utc | string | true | When the site read the capture. |
|---|
boards | object | false | The boards, keyed by board key. |
|---|
boards.{board} | object | false | One board, keyed by its board key (for example 1v1). |
|---|
boards.{board}.display | string | false | Board name as the game shows it. |
|---|
boards.{board}.total | integer | false | Accounts on the whole board. |
|---|
boards.{board}.shown | integer | false | Rows the leaderboard page shows for this board. |
|---|
boards.{board}.rows | array<object> | false | The rows, top first, at most limit. |
|---|
boards.{board}.rows[].rank | integer | false | Position on the board, 1 is the top. |
|---|
boards.{board}.rows[].name | string | true | Name of the account as Steam shows it. |
|---|
boards.{board}.rows[].score | integer | false | Board score, the Rating column of the leaderboard page. |
|---|
boards.{board}.rows[].steam_id | string | true | SteamID64 of the account. |
|---|
boards.{board}.rows[].form | array<boolean> | true | Recent decided results, newest first; true is a win. |
|---|
boards.{board}.rows[].record | object | true | The game's own newest match record for this account. |
|---|
boards.{board}.rows[].record.rating | integer | true | The game's internal rating after the match. |
|---|
boards.{board}.rows[].record.wins | integer | true | The game's season-to-date win counter at the newest match record. |
|---|
boards.{board}.rows[].record.losses | integer | true | The game's season-to-date loss counter at the newest match record. |
|---|
boards.{board}.rows[].record.last_match_utc | string | true | The game's own time of the last match. |
|---|
boards.{board}.rows[].record.opponents | array<object> | false | The game's ring of the last opponents, newest first. |
|---|
boards.{board}.rows[].record.opponents[].steam_id | string | true | SteamID64 of the account. |
|---|
boards.{board}.rows[].record.opponents[].name | string | true | Name of the account as Steam shows it. |
|---|
boards.{board}.rows[].record.opponents[].won | boolean | true | True won, false lost, null no result held. |
|---|
movers | array<object> | true | The biggest gains on the current board, at most 5; null for a closed season. |
|---|
movers[].steam_id | string | true | SteamID64 of the account. |
|---|
movers[].name | string | true | Name of the account as Steam shows it. |
|---|
movers[].delta | integer | true | Score change over the movers window. |
|---|
movers[].score | integer | true | Board score, the Rating column of the leaderboard page. |
|---|
movers_hours | integer | false | Length of the movers window in hours. |
|---|
limit | integer | false | Rows per board this answer applied. |
|---|
reason | string | true | Why the answer is empty or partial, in English; null when it is complete. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. An empty or partial answer is still 200 and says why in reason. |
|---|
400 | mode has a character other than letters, digits, - and _, or limit is not a number in range. |
|---|
404 | season names a season the site holds no data for, or mode names no board. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The store cannot be read (same JSON shape, reason set), or the endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Follows the ranked ladder sweep; captured_utc says when the standings were read from the game. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/rankings?mode=1v1&limit=2
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"archived": false,
"boards": {
"1v1": {
"display": "Season 44 Multiplayer 1v1",
"rows": [
{
"form": [
true,
true,
true
],
"name": "BaumstaenderTTV",
"rank": 1,
"record": {
"last_match_utc": "2026-11-12T14:34:08Z",
"losses": 14,
"opponents": [
{
"name": "Chaewon-Biased",
"steam_id": "76561199567537085",
"won": true
}
],
"rating": 1627,
"wins": 88
},
"score": 4714,
"steam_id": "76561198974455664"
}
],
"shown": 20,
"total": 3490
}
},
"captured_utc": "2026-11-16T23:35:11Z",
"current_season": 44,
"definition": "Ranked standings as /leaderboard shows them: rank, the name Steam shows, and score (the page's Rating column). form is the row's recent decided results, newest…",
"limit": 2,
"movers": [
{
"delta": 115,
"name": "DARKSLAYER",
"score": 4197,
"steam_id": "76561199165732689"
}
],
"movers_hours": 24,
"read_utc": null,
"reason": null,
"schema": "forts-rankings/1",
"season": 44,
"seasons": [
44,
43,
42
],
"source": "https://forts-tools.com/leaderboard"
}
/api/player-search
Accounts matching a name or a SteamID64, as the player search page lists them.
| Request | GET https://forts-tools.com/api/player-search |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-player-search/1 |
|---|
| Same data as | /player/search |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
| Name | In | Type | Required | Notes |
|---|
q | query | string | required | A name or a 17-digit SteamID64, 1 to 64 characters, no control characters; else 400. |
|---|
limit | query | integer | optional | Matches returned, 1 to 20; default 20. Out of range or not a number: 400. |
|---|
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
definition | string | false | What the figures mean, in English. |
|---|
query | string | false | The q this answer is for. |
|---|
limit | integer | false | Matches this answer allowed. |
|---|
matches | array<object> | false | The matching accounts, newest seen first. |
|---|
matches[].steam_id | string | false | SteamID64 of the account. |
|---|
matches[].name | string | true | Name of the account as Steam shows it. |
|---|
matches[].matched | string | true | The name that matched q. |
|---|
matches[].match | string | false | How it matched: id, exact, prefix or squashed. |
|---|
matches[].last_seen | string | true | When the site last saw the account. |
|---|
reason | string | true | Why the answer is empty or partial, in English; null when it is complete. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. An empty or partial answer is still 200 and says why in reason. |
|---|
400 | q is missing, too long or has a control character, or limit is not a number in range. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The store cannot be read (same JSON shape, reason set), or the endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Read on every request from the name store the ladder sweeps fill. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/player-search?q=a&limit=2
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"definition": "Accounts whose name (any name ever seen) equals q, else starts with it, else equals it with case, spaces and punctuation ignored, newest-seen first. A 17-digit…",
"limit": 2,
"matches": [
{
"last_seen": "2026-11-07T04:35:51Z",
"match": "exact",
"matched": "a",
"name": "a",
"steam_id": "76561198889842303"
}
],
"query": "a",
"reason": null,
"schema": "forts-player-search/1",
"source": "https://forts-tools.com/player/search"
}
/api/player/<steamid64>
One player's recorded ranked matches and statistics, as the player page shows them.
| Request | GET https://forts-tools.com/api/player/<steamid64> |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-player/1 |
|---|
| Same data as | /player/<steamid64> |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
| Name | In | Type | Required | Notes |
|---|
steamid64 | path | string | required | The account's SteamID64, exactly 17 digits; anything else: 404. |
|---|
matches | query | integer | optional | History rows returned, 1 to 200; default 50. Out of range or not a number: 400. |
|---|
season | query | integer | optional | Keep one season's matches. Absent: every season held. A season the site holds nothing for: 404. |
|---|
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
definition | string | false | What the figures mean, in English. |
|---|
steam_id | string | false | SteamID64 of the account. |
|---|
found | boolean | false | True when the site holds a ranked match for this id. |
|---|
name | string | true | Name of the account as Steam shows it. |
|---|
rank | integer | true | Current board position; null when off the current standings. |
|---|
score | integer | true | Current board score; null when off the current standings. |
|---|
last_played_utc | string | true | Time of the newest recorded match. |
|---|
wins | integer | true | Season-to-date wins at the newest match; they reset each season. |
|---|
losses | integer | true | Season-to-date losses at the newest match; they reset each season. |
|---|
history_source | string | true | Which records the history was built from. |
|---|
matches_total | integer | false | Matches the player page lists (all seasons, or the season asked for). |
|---|
matches_returned | integer | false | Rows in history. |
|---|
history | array<object> | false | Recorded matches, newest first. |
|---|
history[].at_utc | string | true | Time of the match. |
|---|
history[].won | boolean | true | True won, false lost, null no result held. |
|---|
history[].opponent_steam_id | string | true | SteamID64 of the opponent. |
|---|
history[].opponent_name | string | true | Name of the opponent. |
|---|
history[].opponent_rating | integer | true | The opponent's internal rating. |
|---|
history[].points_delta | integer | true | Board score change from the match. |
|---|
history[].rating | integer | true | The game's internal rating after the match. |
|---|
history[].map | string | true | Map, inferred from the ranked lobby log, not recorded by the game. |
|---|
history[].inferred | boolean | false | True where the page marks the match INFERRED. |
|---|
map_winrates | array<object> | true | Wins and losses per season and map; null when the store cannot be read. |
|---|
map_winrates[].season | string | true | Season number. |
|---|
map_winrates[].map | string | true | Map name; null when not known. |
|---|
map_winrates[].wins | integer | false | Wins counted. |
|---|
map_winrates[].losses | integer | false | Losses counted. |
|---|
map_winrates[].winrate_pct | integer | true | Win rate in whole percent, as the page prints it. |
|---|
map_winrates[].unjoined | integer | false | Matches on this map whose result is not held. |
|---|
names | array<object> | true | Names the account used; null when the store cannot be read. |
|---|
names[].name | string | false | A name the account used. |
|---|
names[].first_seen | string | true | Day the site first saw it. |
|---|
names[].last_seen | string | true | Day the site last saw it. |
|---|
reason | string | true | Why the answer is empty or partial, in English; null when it is complete. |
|---|
season | integer | true | The season asked for; null for every season. |
|---|
seasons | array<integer> | false | Seasons with a row for this id, newest first. |
|---|
page_schema | string | false | Schema marker of the player page's assembly these fields come from. Present when found: true. |
|---|
standing | object | true | The standing the page's tiles show. Present when found: true. |
|---|
standing.season | integer | false | Season number. |
|---|
standing.mode | string | false | Board key, for example 1v1. |
|---|
standing.rank | integer | false | Position on the board, 1 is the top. |
|---|
standing.score | integer | false | Board score, the Rating column of the leaderboard page. |
|---|
standing.total | integer | false | Accounts on the whole board. |
|---|
standing.field | integer | true | Accounts counted for top_pct. |
|---|
standing.top_pct | number | true | Standing as a percentage from the top of the board. |
|---|
standing.provisional | boolean | false | True while too few matches count for a settled standing. |
|---|
standing.games | integer | true | Matches counted. |
|---|
standing.basis | string | true | How the standing was decided. |
|---|
standing.builds | array<string> | false | Game builds the season's matches were played on. |
|---|
career | object | true | Totals over every season held. Present when found: true. |
|---|
career.games | integer | false | Matches counted. |
|---|
career.wins | integer | false | Wins counted. |
|---|
career.losses | integer | false | Losses counted. |
|---|
career.won_pct | number | true | Win percentage over the career. |
|---|
career.seasons | integer | false | Seasons played. |
|---|
career.seasons_counted | integer | false | Seasons whose results are counted in the totals. |
|---|
best_finish | object | true | Best board position held. Present when found: true. |
|---|
best_finish.rank | integer | false | Position on the board, 1 is the top. |
|---|
best_finish.season | integer | false | Season number. |
|---|
best_finish.mode | string | false | Board key, for example 1v1. |
|---|
best_rating | object | true | Highest board score held. Present when found: true. |
|---|
best_rating.score | integer | false | Board score, the Rating column of the leaderboard page. |
|---|
best_rating.season | integer | false | Season number. |
|---|
internal_rating | integer | true | The game's internal rating after the match. Present when found: true. |
|---|
season_results | array<object> | false | One entry per season and board. Present when found: true. |
|---|
season_results[].season | integer | false | Season number. |
|---|
season_results[].mode | string | false | Board key, for example 1v1. |
|---|
season_results[].rank | integer | true | Position on the board, 1 is the top. |
|---|
season_results[].score | integer | true | Board score, the Rating column of the leaderboard page. |
|---|
season_results[].peak | integer | true | Highest score reached in the season. |
|---|
season_results[].wins | integer | true | Wins counted. |
|---|
season_results[].losses | integer | true | Losses counted. |
|---|
season_results[].games | integer | true | Matches counted. |
|---|
season_results[].wl_basis | string | true | Where wins and losses come from. |
|---|
season_results[].top_pct | number | true | Standing as a percentage from the top of the board. |
|---|
season_results[].provisional | boolean | false | True while too few matches count for a settled standing. |
|---|
season_results[].standing_basis | string | true | How the standing was decided. |
|---|
season_results[].builds | array<string> | false | Game builds the season's matches were played on. |
|---|
streak | object | true | Win and loss streaks. Present when found: true. |
|---|
streak.current | object | true | The running streak; null when none. |
|---|
streak.current.won | boolean | false | True for a win streak, false for a loss streak. |
|---|
streak.current.n | integer | false | Length of the streak. |
|---|
streak.longest_won | integer | false | Longest win streak. |
|---|
streak.longest_lost | integer | false | Longest loss streak. |
|---|
form_recent | array<boolean> | false | Recent results, newest first; true is a win. Present when found: true. |
|---|
head_to_head | array<object> | false | Record against each opponent, most games first. Present when found: true. |
|---|
head_to_head[].steam_id | string | false | SteamID64 of the account. |
|---|
head_to_head[].name | string | true | Name of the account as Steam shows it. |
|---|
head_to_head[].games | integer | false | Matches counted. |
|---|
head_to_head[].wins | integer | false | Wins counted. |
|---|
head_to_head[].losses | integer | false | Losses counted. |
|---|
head_to_head[].last_played_utc | string | true | Time of the last match against this opponent. |
|---|
activity_weeks | array<object> | false | Matches per week, oldest first. Present when found: true. |
|---|
activity_weeks[].week | string | false | First day of the week. |
|---|
activity_weeks[].games | integer | false | Matches that week. |
|---|
avatar_url | string | true | Same-origin path of the account's avatar. Present when found: true. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. A well-formed id with no recorded match is 200 with found false, the same answer for every such id. |
|---|
400 | matches is not a number in range. |
|---|
404 | The path segment is not a 17-digit SteamID64, or season names a season the site holds nothing for. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits), including the crawler limit; the proxy's answer is an HTML page with Retry-After. |
|---|
500 | An unexpected server fault. |
|---|
503 | The store cannot be read (same JSON shape, reason set), the endpoint is switched off, or every player slot is busy (Retry-After 10). |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Server-side reuse | A computed answer is reused for up to 60 s; new data from the stores replaces it at once. |
|---|
| Freshness | Follows the ranked ladder sweep and the match records; last_played_utc is the newest recorded match. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Requests per crawler (proxy) | 60r/m burst=6 | Applies when the User-Agent names itself a crawler, shared across every address it uses. Over the burst: 429 with Retry-After 10. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/player/76561198974455664?matches=2
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"activity_weeks": [
{
"games": 1,
"week": "2025-11-24"
}
],
"avatar_url": "/avatar/h/c956e27fa4112156c39d28ea0ac7b271a7abdd8f?size=medium",
"best_finish": {
"mode": "1v1",
"rank": 1,
"season": 44
},
"best_rating": {
"score": 4714,
"season": 44
},
"career": {
"games": 2101,
"losses": 698,
"seasons": 25,
"seasons_counted": 24,
"wins": 1403,
"won_pct": 66.8
},
"definition": "One player's recorded ranked matches as /player/<id> shows them. rank and score are the current /leaderboard position and Rating, null when this id is not on t…",
"form_recent": [
true,
true,
true
],
"found": true,
"head_to_head": [
{
"games": 16,
"last_played_utc": "2026-01-27T17:16:58Z",
"losses": 11,
"name": "Julian",
"steam_id": "76561199507205564",
"wins": 4
}
],
"history": [
{
"at_utc": "2026-11-12T14:34:08Z",
"inferred": false,
"map": "Hillfort",
"opponent_name": "Chaewon-Biased",
"opponent_rating": 1483,
"opponent_steam_id": "76561199567537085",
"points_delta": 11,
"rating": 1627,
"won": true
}
],
"history_source": "combined",
"internal_rating": 1627,
"last_played_utc": "2026-11-12T14:34:08Z",
"losses": 14,
"map_winrates": [
{
"losses": 5,
"map": "Split",
"season": "44",
"unjoined": 0,
"winrate_pct": 77,
"wins": 17
}
],
"matches_returned": 2,
"matches_total": 626,
"name": "BaumstaenderTTV",
"names": [
{
"first_seen": "2026-08-02",
"last_seen": "2026-11-16",
"name": "BaumstaenderTTV"
}
],
"page_schema": "forts-player-page/1",
"rank": 1,
"reason": null,
"schema": "forts-player/1",
"score": 4714,
"season": null,
"season_results": [
{
"builds": [
"1.38.2-r22447",
"1.39.0-r22745",
"1.39.0-r22875"
],
"games": 102,
"losses": 14,
"mode": "1v1",
"peak": 4714,
"provisional": false,
"rank": 1,
"score": 4714,
"season": 44,
"standing_basis": "games10",
"top_pct": 0.1,
"wins": 88,
"wl_basis": "record"
}
],
"seasons": [
44,
43,
42
],
"source": "https://forts-tools.com/player/76561198974455664",
"standing": {
"basis": "games10",
"builds": [
"1.38.2-r22447",
"1.39.0-r22745",
"1.39.0-r22875"
],
"field": 953,
"games": 102,
"mode": "1v1",
"provisional": false,
"rank": 1,
"score": 4714,
"season": 44,
"top_pct": 0.1,
"total": 3490
},
"steam_id": "76561198974455664",
"streak": {
"current": {
"n": 18,
"won": true
},
"longest_lost": 6,
"longest_won": 20
},
"wins": 88
}
/api/player-names
Every account a season's ranked ladder listed, with the names it is known by.
| Request | GET https://forts-tools.com/api/player-names |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-ranked-names/1 |
|---|
| Same data as | /leaderboard |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
| Name | In | Type | Required | Notes |
|---|
season | query | integer | optional | Season number. Absent: the current season. A season the site holds no data for, or anything but 1 to 3 digits: 404. |
|---|
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
definition | string | false | What the figures mean, in English. |
|---|
season | integer | true | Season number. |
|---|
current_season | integer | true | The season the live board is in. |
|---|
seasons | array<integer> | false | Every season the site holds, newest first. |
|---|
archived | boolean | false | True when the answer is a closed season. |
|---|
captured_utc | string | true | When the standings were read from the game. |
|---|
generated_utc | string | true | When this answer was computed. |
|---|
total | integer | false | Accounts found for the season. |
|---|
on_board | integer | false | Accounts on the season's standings. |
|---|
unresolved | integer | false | Standings rows whose account could not be resolved, left out. |
|---|
truncated | boolean | false | True when more than 25000 accounts were found and the list is cut. |
|---|
players | array<object> | false | One entry per account: standings rows first, then every other account the season's sweeps listed. |
|---|
players[].steam_id | string | false | SteamID64 of the account. |
|---|
players[].name | string | true | The name the standings or newest sweep carried; null for a placeholder. |
|---|
players[].rank | integer | true | Rank on the season's standings; null when not on them. |
|---|
players[].board | string | true | Board key the account was listed on. |
|---|
players[].other_names | array<string> | false | Other names the account used, newest first, at most 20. |
|---|
players[].wins | integer | true | The game's season-to-date win counter at the newest match record. |
|---|
players[].losses | integer | true | The game's season-to-date loss counter at the newest match record. |
|---|
reason | string | true | Why the answer is empty or partial, in English; null when it is complete. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. An empty or partial answer is still 200 and says why in reason. |
|---|
304 | Not modified: If-None-Match matched the current ETag. |
|---|
404 | season names a season the site holds no data for. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The store cannot be read (same JSON shape, reason set), or the endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | public, max-age=300 |
|---|
| Validators | Weak ETag; a matching If-None-Match is answered 304 with no body. Content-Encoding: gzip when the request sends Accept-Encoding: gzip. |
|---|
| Server-side reuse | A computed answer is reused for up to 300 s; new data from the stores replaces it at once. |
|---|
| Freshness | Follows the ranked ladder sweep; captured_utc says when the standings were read from the game. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/player-names
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"archived": false,
"captured_utc": "2026-11-16T23:35:11Z",
"current_season": 44,
"definition": "Every account the season's ranked sweeps listed. rank is the /leaderboard rank, null when the account is not on the season's standings (current, or a closed se…",
"generated_utc": "2026-11-16T23:35:42Z",
"on_board": 3490,
"players": [
{
"board": "1v1",
"losses": 14,
"name": "BaumstaenderTTV",
"other_names": [],
"rank": 1,
"steam_id": "76561198974455664",
"wins": 88
}
],
"reason": null,
"schema": "forts-ranked-names/1",
"season": 44,
"seasons": [
44,
43,
42
],
"source": "https://forts-tools.com/leaderboard",
"total": 3495,
"truncated": false,
"unresolved": 0
}
/api/players
The player and lobby counts the lobbies page shows for the live game build.
| Request | GET https://forts-tools.com/api/players |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-players/1 |
|---|
| Same data as | /lobbies |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
No parameters.
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
definition | string | false | What the figures mean, in English. |
|---|
lobbies_definition | string | false | What the lobby counts mean, in English. |
|---|
captured_utc | string | true | When the newest player count was taken. |
|---|
age_s | integer | true | Seconds since that count. |
|---|
players | integer | true | Players in game, Valve's own current-player count. |
|---|
players_peak | integer | true | Highest players figure since peak_since_utc. |
|---|
peak_since_utc | string | true | Start of the window players_peak covers. |
|---|
samples | integer | false | Counts held in the window. |
|---|
build | string | true | The live game build the lobby counts are for. |
|---|
lobbies | object | true | Lobbies for the live build, per state. |
|---|
lobbies.{bucket} | integer | false | Lobbies in this state. Keys: open, locked, forming, not_started, in_progress, total |
|---|
by_mode | object | true | The same counts split into ranked and casual. |
|---|
by_mode.{mode} | object | false | Counts per state for one mode. Keys: ranked, casual |
|---|
by_mode.{mode}.{bucket} | integer | false | Lobbies in this state. Keys: open, locked, forming, not_started, in_progress, total |
|---|
coverage_complete | boolean | true | True when the lobby list was read in full. |
|---|
result_cap | integer | true | Most lobbies one list request returns. |
|---|
reason | string | true | Why the answer is empty or partial, in English; null when it is complete. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. An empty or partial answer is still 200 and says why in reason. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The store cannot be read (same JSON shape, reason set), or the endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Read on every request; captured_utc and age_s say when the newest count was taken. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/players
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"age_s": 6,
"build": "1.39.0",
"by_mode": {
"casual": {
"forming": 0,
"in_progress": 12,
"locked": 2,
"not_started": 3,
"open": 1,
"total": 15
},
"ranked": {
"forming": 0,
"in_progress": 1,
"locked": 0,
"not_started": 0,
"open": 0,
"total": 1
}
},
"captured_utc": "2026-11-16T23:35:37Z",
"coverage_complete": true,
"definition": "Players in game: Valve's own current-player count for Forts (ISteamUserStats/GetNumberOfCurrentPlayers) at the newest count, drawn on /lobbies as the 'Players …",
"lobbies": {
"forming": 0,
"in_progress": 13,
"locked": 2,
"not_started": 3,
"open": 1,
"total": 16
},
"lobbies_definition": "Lobbies on the public Steam lobby list for the live build at the newest count, as the /lobbies headline table shows them; not_started = open + password + filli…",
"peak_since_utc": "2026-11-02T23:35:39Z",
"players": 181,
"players_peak": 673,
"reason": null,
"result_cap": 50,
"samples": 214478,
"schema": "forts-players/1",
"source": "https://forts-tools.com/lobbies"
}
/api/live
Ranked matches in progress and ranked lobbies waiting for an opponent, as the live page shows them.
| Request | GET https://forts-tools.com/api/live |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-live/1 |
|---|
| Same data as | /live |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
No parameters.
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
generated_utc | string | false | When this answer was built. |
|---|
win_chance_method | string | false | How win_chance is computed, in English. |
|---|
matches | array<object> | false | Ranked matches running now, newest start first. |
|---|
matches[].started_utc | string | true | When the match started. |
|---|
matches[].map | string | true | Map name; null when not known. |
|---|
matches[].season | string | true | Season the lobby named. |
|---|
matches[].build | string | true | Game build at the match's start. |
|---|
matches[].basis | string | false | Which feeds show the match: lobby, record or both. |
|---|
matches[].method | string | true | How win_chance was computed for this match: elo or stake; null when neither applies. |
|---|
matches[].players | array<object> | false | The two players. |
|---|
matches[].players[].steam_id | string | false | SteamID64 of the account. |
|---|
matches[].players[].name | string | true | Name of the account as Steam shows it. |
|---|
matches[].players[].rank | integer | true | Position on the board, 1 is the top. |
|---|
matches[].players[].score | integer | true | Board score, the Rating column of the leaderboard page. |
|---|
matches[].players[].rating | integer | true | Internal rating before the match. |
|---|
matches[].players[].stake | integer | true | Points at stake for this player. |
|---|
matches[].players[].win_chance | number | true | Expected chance of winning, 0 to 1. |
|---|
lobby_list_captured_utc | string | true | When the lobby list was captured. |
|---|
queue_captured_utc | string | true | Same as lobby_list_captured_utc; kept for clients that read it. |
|---|
open_ranked | array<object> | false | Ranked lobbies waiting for an opponent: not started, no password, and players below max_players. A lobby leaves this list as soon as the opponent joins. |
|---|
open_ranked[].host_steam_id | string | true | SteamID64 of the host. |
|---|
open_ranked[].host_name | string | true | Name of the host. |
|---|
open_ranked[].host_rank | integer | true | The host's board position. |
|---|
open_ranked[].host_score | integer | true | The host's board score. |
|---|
open_ranked[].host_rating | integer | true | The host's internal rating. |
|---|
open_ranked[].rankscore | integer | true | Score the lobby advertises. |
|---|
open_ranked[].max_players | integer | true | Seats in the lobby. |
|---|
open_ranked[].map | string | true | Map name; null when not known. |
|---|
open_ranked[].version | string | true | Game version. |
|---|
open_ranked[].region | string | true | Region the lobby is hosted in. |
|---|
open_ranked[].first_seen_utc | string | true | When the lobby was first listed. |
|---|
open_ranked[].queue_state | string | true | The lobby's queue state token. |
|---|
open_ranked[].tick_age_s | integer | true | Seconds since the lobby last updated. |
|---|
error | string | false | Why the answer holds nothing, in English. Present only when the store cannot be read; the answer then holds schema and this field only. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer, also when the store cannot be read: the body then holds schema and error only. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Read on every request; lobby_list_captured_utc is the time of the lobby list the answer was built from. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/live
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"generated_utc": "2026-11-16T23:35:43Z",
"lobby_list_captured_utc": "2026-11-16T23:35:37Z",
"matches": [
{
"basis": "both",
"build": "1.39.0-r22875",
"map": "Pillars",
"method": "elo",
"players": [
{
"name": "枯木龙吟干死阅览",
"rank": 1983,
"rating": 973,
"score": 4049,
"stake": 15,
"steam_id": "76561198733505730",
"win_chance": 0.4741190691088309
}
],
"season": "44",
"started_utc": "2026-11-16T23:35:02Z"
}
],
"open_ranked": [],
"queue_captured_utc": "2026-11-16T23:35:37Z",
"schema": "forts-live/1",
"win_chance_method": "elo: 1/(1+10^((Rb-Ra)/400)) on internal ratings before the match, K=32; stake: E = stake/32"
}
/api/builds
The game builds the old-build page offers, newest first.
| Request | GET https://forts-tools.com/api/builds |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-builds/1 |
|---|
| Same data as | /steamcmd |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
No parameters.
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
builds | array<object> | false | Game builds, newest first. |
|---|
builds[].id | string | false | The site's id for the build: version and revision. |
|---|
builds[].version | string | false | Game version. |
|---|
builds[].revision | string | true | The game's revision. |
|---|
builds[].label | string | false | Display name of the build. |
|---|
builds[].build_id | string | true | Steam's build id. |
|---|
builds[].released | string | true | Release day. |
|---|
builds[].current | boolean | false | True for the live build. |
|---|
builds[].steamcmd | boolean | false | True when the old-build page can write a SteamCMD command for it. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. An empty or partial answer is still 200 and says why in reason. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Changes when a game build is added to the site. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/builds
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"builds": [
{
"build_id": "26581374",
"current": true,
"id": "1.39.0-r22875",
"label": "Forts 1.39.0 (r22875)",
"released": "2026-11-11",
"revision": "r22875",
"steamcmd": true,
"version": "1.39.0"
}
],
"schema": "forts-builds/1",
"source": "https://forts-tools.com/steamcmd"
}
/api/data
The data files the data page offers, in its order, with their checksums.
| Request | GET https://forts-tools.com/api/data |
|---|
| Methods | GET, HEAD |
|---|
| Response body | application/json; charset=utf-8 |
|---|
| Schema marker | forts-data/1 |
|---|
| Same data as | /data |
|---|
| Authentication | None. No key, no origin allow-list. |
|---|
Parameters
No parameters.
Response
| Field | Type | Nullable | Description |
|---|
schema | string | false | Schema marker of this answer. |
|---|
source | string | false | The page that shows the same data. |
|---|
generated | string | true | Day the files were published. |
|---|
provenance | string | true | Where the data comes from, in English. |
|---|
files | array<object> | false | The files, in the data page's order. |
|---|
files[].file | string | false | File name. |
|---|
files[].url | string | false | Download path on this site. |
|---|
files[].kind | string | false | Kind of file. |
|---|
files[].patch | string | false | Game version and revision the file covers. |
|---|
files[].build | string | false | Steam build id; empty for a file spanning several builds. |
|---|
files[].size | string | false | Size, written for people. |
|---|
files[].sha256 | string | false | SHA-256 of the file. |
|---|
files[].description | string | false | What the file holds, in English. |
|---|
Statuses
| Status | Meaning |
|---|
200 | The answer. An empty or partial answer is still 200 and says why in reason. |
|---|
405 | A method other than GET or HEAD. |
|---|
429 | A rate limit (see Limits): the proxy's, as an HTML page, or the application's, as JSON with Retry-After and RateLimit headers. |
|---|
500 | An unexpected server fault. |
|---|
503 | The endpoint is switched off. |
|---|
Caching and freshness
| Cache-Control | no-store, max-age=0 |
|---|
| Freshness | Changes when the data files are published again; generated is their date. |
|---|
Limits
| Limit | Value | Notes |
|---|
| Requests per address (proxy) | 300r/m burst=100 | Over the burst: 429 with Retry-After 1. |
|---|
| Open connections per address (proxy) | 8 | One more: 429. Over HTTP/2 each request in flight counts. |
|---|
| Request budget per address (application) | 120/60s | One bucket for the whole site, page views included; each read costs 1. Empty: 429 with Retry-After and RateLimit headers. |
|---|
Example request
curl -s https://forts-tools.com/api/data
Example response
A real response from this site, trimmed: long arrays cut to their first entries and long text shortened.
{
"files": [
{
"build": "26581374",
"description": "Every buildable item's numbers for the current game build — weapons, devices, materials, projectiles, commanders and what each commander changes.",
"file": "Forts_SourceOfTruth_1-39-0_r22875_build26581374.xlsx",
"kind": "workbook",
"patch": "1.39.0 r22875",
"sha256": "cf94f545e5ea682792f32b2717874f7768be644b62c57da8bc1ad8117f55f091",
"size": "199 KB",
"url": "/data/Forts_SourceOfTruth_1-39-0_r22875_build26581374.xlsx"
}
],
"generated": "2026-11-11",
"provenance": "This automates a pipeline these people built by hand; it does not replace their work. It was built against Endo's dump mod, which is where these numbers first …",
"schema": "forts-data/1",
"source": "https://forts-tools.com/data"
}
Uploads
The upload endpoints take a file by POST; a long answer comes in pages, the further pages by GET. Each is documented on its own tool's page.