We need your help.. We need donations to stay operational https://paypal.me/ucjohn - Any contribution helps greatly!

For community websites

Show your server's stats on your own website.

A read only JSON API and two ready made embeds. No key, no account, nothing to install. The server owner turns it on for one server in the RCON console, and only then does it work.

Turn it on

Open your server in the RCON console, choose Public API in the Server section, and switch it on. It needs player stats tracking to be on for that server. Until you switch it on, every address below answers as if the server does not exist. You can switch it off again at any time and it stops within a minute.

Your server's id is the number in its stats page address: https://wardogsnow.com/stats/servers/12.

Embeds

Paste one of these into your page. They are plain HTML with no scripts, refresh themselves every minute, and match a dark or light page with theme=dark or theme=light.

Server status

HTML · Status card
<iframe
  src="https://wardogsnow.com/embed/v1/servers/12/status"
  title="Server status"
  width="100%" height="280"
  style="border:0;max-width:520px"
  loading="lazy"></iframe>

Leaderboard

HTML · Leaderboard
<iframe
  src="https://wardogsnow.com/embed/v1/servers/12/leaderboard?limit=10&window=30d"
  title="Top players"
  width="100%" height="500"
  style="border:0;max-width:520px"
  loading="lazy"></iframe>

Set the iframe height to fit: the status card needs about 250 px, and the leaderboard about 110 px plus 33 px per row (so 500 px for ten players).

ParameterValuesDefault
themedark, lightdark
sortkills, kd, time, wins, matches, cash (leaderboard)kills
windowall, 30d, 7d (leaderboard)all
limit1 to 25 (leaderboard)10
seasona season slug, or allthe current season

JSON API

Base address https://wardogsnow.com/api/public/v1. Read only: GET, HEAD and OPTIONS. Any website may call it from the browser (CORS is open, and no cookies are used or accepted).

EndpointReturns
/servers/{id}State (online, offline, unknown), players now and maximum, map, mode, season totals, and top_weapons. map and mode are the names players see in the game, for example Bakurani and King of the Hill. mode also carries any ruleset, such as King of the Hill, Infantry only. Either is null when the server has not reported one. totals.cash is cash recorded on this server. totals.headshots and top_weapons come from the kill feed.
/servers/{id}/leaderboardTop players. Each row has kills, deaths, K/D, cash, headshots, time, matches, wins, and top_weapon. Use sort=cash to order by cash.
/servers/{id}/players/{steamId}One player's totals on this server, including cash, headshots, longest_m, longest_headshot_m, and weapons (up to three, most used first). steamId is the 17 digit SteamID64.

Example

cURL
curl https://wardogsnow.com/api/public/v1/servers/12
JSON · Response
{
  "ok": true,
  "data": {
    "id": 12,
    "name": "Example Server",
    "state": "online",
    "players": 41,
    "max_players": 64,
    "map": "Bakurani",
    "mode": "King of the Hill",
    "totals": { "players_tracked": 812, "matches": 391, "hours": 5120, "cash": 1844200, "headshots": 960 },
    "top_weapons": [
      { "name": "AK-74", "kills": 640, "headshots": 91, "image": "https://wardogsnow.com/assets/img/armory/imported/weapons--ak74.png" }
    ],
    "season": { "slug": "season-1", "name": "Season 1" },
    "stats_url": "https://wardogsnow.com/stats/servers/12"
  },
  "meta": { "version": "v1", "generated_at": "2026-01-01T12:00:00+00:00", "cache_seconds": 30 }
}
JavaScript
const res = await fetch("https://wardogsnow.com/api/public/v1/servers/12/leaderboard?limit=10");
const { data } = await res.json();
for (const p of data.players) {
  console.log(p.rank, p.name, p.kills, p.kd);
}

Leaderboard row

JSON · One row of data.players
{ "rank": 1, "steam_id": "76561198000000000", "name": "Player", "kills": 4210, "deaths": 2980,
  "kd": 1.41, "cash": 88210, "headshots": 640, "hours": 212.5, "matches": 96, "wins": 51, "win_rate": 53,
  "top_weapon": { "name": "AK-74", "kills": 900, "headshots": 140, "image": null } }

Cash and weapons

cash is a whole number, the cash the console recorded for that player on this server during the season. On the server payload it is the total for everyone. Sort a leaderboard with ?sort=cash.

Headshots, longest shot, and weapon names come from the kill feed. If that feed was off, headshots is 0, the longest fields are 0, and weapons is an empty list. That is a real answer, not a missing field.

A weapon object is name, kills, headshots, and image. image is a full picture address, or null when there is no art for that name. Show the name either way. weapons on a player is already the top three, highest kills first. top_weapon on a leaderboard row is the first of those, or null.

Errors

JSON · Error
{ "ok": false, "error": { "code": "not_found", "message": "Not found." } }

404 not_found means the server is unknown, is not tracked, or the owner has not switched the API on; these are deliberately indistinguishable. 429 rate_limited carries a Retry-After header. 405 is any method other than GET, HEAD or OPTIONS.

Fair use

  • Cache on your side. Data refreshes about once a minute. Responses are cacheable for 30 to 60 seconds (see meta.cache_seconds). Fetching more often returns the same numbers.
  • Limit: 120 requests per minute per address. Over that, you get 429 until the minute passes.
  • Attribution: the embeds link back here. If you build your own display from the JSON, a small link to the server's stats page (data.stats_url) is appreciated.
  • Players: names and SteamID64 appear exactly as on the public stats pages. A player who asked to be removed is not returned. Please do not use the data to profile or harass people.
  • Stability: everything under /v1/ only ever gains fields. A breaking change would be published as /v2/, with v1 kept running for a long notice period.