Authentication

All API endpoints (except static assets) require an API key. You can generate a free key from the developer dashboard. Pass the key in the x-api-key request header.

BASH

curl -H "x-api-key: cs2_YOUR_KEY" https://cs2.space/api/profile/76561198160154018

GET /profile/:id

The primary endpoint. Fetches and aggregates full player data from Steam, Faceit, and Leetify. Accepts either a SteamID64 or a Custom Steam Vanity URL.
NOTE: Free tier accounts only receive Steam data and assets. Upgrade to PRO for Faceit/Leetify aggregation.

Valid: 76561198160154018Valid: the_c0unter_str1ker

Response Structure:

JSON

{
  "steamId": "76561198160154018",
  "steam": {
    "player": { "personaname": "PlayerName", "avatarfull": "https://..." },
    "level": 32,
    "bans": { "VACBanned": false, "NumberOfVACBans": 0 },
    "ownedGames": [...],
    "cs2Stats": { "total_kills": 42000, "total_wins": 500, ... }
  },
  "faceit": {
    "player_id": "faceit-uuid-here",
    "nickname": "PlayerName_FCT",
    "games": {
      "cs2": {
        "skill_level": 10,
        "faceit_elo": 2540,
        "region": "EU"
      }
    }
  },
  "leetify": {
    "meta": { "name": "PlayerName" },
    "games": [{
      "dataSource": "matchmaking",
      "skillLevel": 18 // Global Elite
    }],
    "recentGameRatings": { "aim": 78, "positioning": 65, "utility": 45 }
  }
}

GET /steamid/:id

A lightweight endpoint specifically for resolving Steam Vanity URLs to SteamID64s, and converting between Steam ID formats (Steam2, Steam3, Steam32). Also returns basic profile info.

JSON

{
  "steam32": 199888290,
  "steam64": "76561198160154018",
  "steam2": "STEAM_0:0:99944145",
  "steam3": "[U:1:199888290]",
  "profile_url": "https://steamcommunity.com/id/...",
  "avatar": "https://avatars.steamstatic.com/..._full.jpg",
  "name": "PlayerName"
}

API Key Management

Programmatic management of your API keys. Requires an active session via cookie (authenticated via Steam/Google on the dashboard).

POST /keys/generate

Generates a new API key tied to your account. Returns { "apiKey": "cs2_..." }

GET /keys

Returns an array of your active keys and their usage counts.

Rate Limits & Status Codes

To ensure stable performance, the API enforces rate limiting and monthly quotas. Limits are calculated across all keys associated with your account.

Free Tier: 500 calls/mo @ 1 req/sec
Pro Tier: 10,000 calls/mo @ 10 req/sec
Developer Tier: 100,000+ calls/mo @ 50+ req/sec
Exceeding these limits will result in a 429 Too Many Requests response.

HTTP Status Codes:

200 OK - The request was successful.

400 Bad Request - Invalid parameters (e.g., malformed SteamID).

401 Unauthorized - Missing or invalid API Key.

403 Forbidden - API key does not have access to this endpoint.

404 Not Found - The requested profile or asset does not exist.

429 Too Many Requests - Rate limit exceeded.

500 Internal Server Error - Something went wrong on our end.

Asset Explorer

We serve all necessary CS2 SVGs and PNGs so you don't have to hunt them down. These do not require an API key. Click on a category below to browse the available assets and their exact URL paths. Or use the base prefix: https://cs2.space/api/assets/