FACEIT API

Preview three player-card results: returned metrics, missing data and a failed history request.

1. Resolve the playerSend a SteamID64 as game_player_id with game=cs2. Read ELO and level from games.cs2.faceit_elo and games.cs2.skill_level.
2. Keep the FACEIT player IDUse the returned player_id in the stats and history paths. A SteamID64 or nickname is not a replacement for that identifier.
3. Fetch only the extra data you needRead lifetime for aggregate statistics. Optional segments[] contains Map or Competition breakdowns with the source mode in the same response. A Competition label is a competition ID, not a resolved name. Read items[] for matches; optional match_stats.Headshots is a count, not a percentage. Select a page with an explicit HTTP request using page from 0 through 100 and limit from 1 through 20. Page positions can shift.

Download the FACEIT fields and pagination guide (Markdown) for data bounds, optional fields and an explicit HTTP page request. SDK 1.3.0 requests only the first history page.

Store WOK_API_KEY and a 17-digit WOK_STEAM_ID in your server environment. Use a Players or all-purpose key with FACEIT access; no separate FACEIT key is needed. Never expose the WOK key in browser code, a bot message or a public URL.

Three requests with cURL

# Set WOK_API_KEY and WOK_STEAM_ID in your server environment.
set -eu
curl --fail-with-body --max-time 35 --get \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/faceit/data/v4/players" \
  --data-urlencode "game=cs2" \
  --data-urlencode "game_player_id=$WOK_STEAM_ID"

# Copy player_id from that response into WOK_FACEIT_PLAYER_ID.
curl --fail-with-body --max-time 35 \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/faceit/data/v4/players/$WOK_FACEIT_PLAYER_ID/stats/cs2"
curl --fail-with-body --max-time 35 \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/faceit/data/v4/players/$WOK_FACEIT_PLAYER_ID/history?game=cs2&limit=5"

# Python 3: install requests; set WOK_API_KEY and WOK_STEAM_ID.
import json
import os
import re
import requests

steam_id = os.environ["WOK_STEAM_ID"]
if not re.fullmatch(r"[0-9]{17}", steam_id):
    raise SystemExit("WOK_STEAM_ID must be a 17-digit SteamID64")
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['WOK_API_KEY']}"

def read(path, params=None, *, allow_missing=False):
    response = session.get("https://woksteamapi.com" + path,
                           params=params, timeout=(5, 30),
                           allow_redirects=False)
    if allow_missing and response.status_code == 404:
        return None
    response.raise_for_status()  # Stop on key, quota or source errors.
    return response.json()

profile = read("/faceit/data/v4/players", {
    "game": "cs2", "game_player_id": steam_id,
}, allow_missing=True)
if profile is None:
    raise SystemExit("No FACEIT CS2 profile for this SteamID64")
player_id = profile.get("player_id", "")
if not re.fullmatch(r"[A-Za-z0-9-]{1,64}", player_id):
    raise SystemExit("The profile did not return a valid player_id")
# These two extra calls are optional: omit data your page does not need.
stats = read(f"/faceit/data/v4/players/{player_id}/stats/cs2")
history = read(f"/faceit/data/v4/players/{player_id}/history",
               {"game": "cs2", "limit": 5})
print(json.dumps({
    "nickname": profile.get("nickname"),
    "rank": profile.get("games", {}).get("cs2", {}),
    "lifetime": stats.get("lifetime", {}),
    "recent_matches": history.get("items", []),
}, indent=2))

// Node.js 18+: set WOK_API_KEY and WOK_STEAM_ID on your server.
const key = process.env.WOK_API_KEY;
const steamId = process.env.WOK_STEAM_ID;
if (!key || !/^[0-9]{17}$/.test(steamId || "")) {
  throw new Error("Set WOK_API_KEY and a 17-digit WOK_STEAM_ID");
}
async function read(path, params = {}, allowMissing = false) {
  const url = new URL(path, "https://woksteamapi.com");
  url.search = new URLSearchParams(params);
  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${key}` },
    signal: AbortSignal.timeout(35_000),
    redirect: "error"
  });
  if (allowMissing && response.status === 404) return null;
  if (!response.ok) throw new Error(`WOK HTTP ${response.status}`);
  return response.json();
}
const profile = await read("/faceit/data/v4/players", {
  game: "cs2", game_player_id: steamId
}, true);
if (!profile) throw new Error("No FACEIT CS2 profile for this SteamID64");
if (!/^[A-Za-z0-9-]{1,64}$/.test(profile.player_id || "")) {
  throw new Error("The profile did not return a valid player_id");
}
const playerPath = `/faceit/data/v4/players/${encodeURIComponent(profile.player_id)}`;
// Optional reads: request only what the player page needs.
const stats = await read(`${playerPath}/stats/cs2`);
const history = await read(`${playerPath}/history`, { game: "cs2", limit: "5" });
console.log({ nickname: profile.nickname, rank: profile.games?.cs2,
  lifetime: stats.lifetime, recent_matches: history.items });

These clients make at most three requests and stop on an error; they do not automatically retry. The complete workflow uses three quota units when all calls are admitted. Each profile, stats or history call costs one unit, including cache hits. GET /v1/key reports access, remaining quota and reset times without consuming a request unit.

Read the response without inventing missing data

lifetime metrics such as Matches, Wins and Average K/D Ratio are strings when present. Missing fields are unavailable, not zero. Recent-match rows can contain finished_at (Unix seconds), elo, elo_delta and match_stats with map, score, kills and deaths. Escape names and labels before displaying them as HTML.

Handle absence, access and temporary failures separately

Cache age and source scope

Profile and lifetime snapshots use a configurable cache TTL of six hours by default. A cached rank can lag a newly finished match. Recent history has no persistent result cache and makes a separate bounded source request; it still depends on FACEIT availability and does not guarantee immediate publication of a finished match. These responses do not expose an observation timestamp or exact cache age, so do not infer freshness from the time your client fetched them.

WOK adapts confirmed public website-source fields; it does not promise complete official FACEIT API coverage. Optional memberships and friends_count do not prove paid status or a complete friends list. Steam profiles and inventories are separate requests, and no endpoint unlocks private Steam data.

{
  "profile": {
    "http_status": 200,
    "body": {
      "player_id": "example-player",
      "nickname": "Example player",
      "games": {
        "cs2": {
          "faceit_elo": 1450,
          "skill_level": 6
        }
      }
    }
  },
  "stats": {
    "http_status": 200,
    "body": {
      "lifetime": {
        "Matches": "120",
        "Wins": "68",
        "Average K/D Ratio": "1.10"
      }
    }
  },
  "history": {
    "http_status": 200,
    "body": {
      "start": 0,
      "end": 1,
      "items": [
        {
          "match_id": "example-match",
          "game_id": "cs2",
          "elo": 1450,
          "elo_delta": 20,
          "match_stats": {
            "Kills": "24",
            "Deaths": "16",
            "Headshots": "12"
          }
        }
      ]
    }
  }
}

{
  "profile": {
    "http_status": 200,
    "body": {
      "player_id": "example-player",
      "nickname": "Example player",
      "games": {
        "cs2": {
          "faceit_elo": 1450,
          "skill_level": 6
        }
      }
    }
  },
  "stats": {
    "http_status": 200,
    "body": {
      "lifetime": {}
    }
  },
  "history": {
    "http_status": 200,
    "body": {
      "start": 0,
      "end": 0,
      "items": []
    }
  }
}

{
  "profile": {
    "http_status": 200,
    "body": {
      "player_id": "example-player",
      "nickname": "Example player",
      "games": {
        "cs2": {
          "faceit_elo": 1450,
          "skill_level": 6
        }
      }
    }
  },
  "stats": {
    "http_status": 200,
    "body": {
      "lifetime": {
        "Matches": "0",
        "Wins": "0"
      }
    }
  },
  "history": {
    "http_status": 502
  }
}

Run a combined Steam and FACEIT player card

Download the Steam + FACEIT Python example and follow its setup and run instructions. Use the resolved SteamID64 to join the two services; keep Steam identity and FACEIT rank in separate fields. A missing FACEIT account does not invalidate a Steam profile, and missing rank or lifetime metrics should remain unavailable rather than becoming zero. Keep the WOK key on your server.

Full API reference · OpenAPI contract · Add a Steam profile · CS2 integration map · Check plans and request limits