CS2.SPACEDocumentationAPI
HomeDASHBOARD →
Base URL: https://cs2.space

Player profile

GETx-api-key required

Everything about a player in one call: Steam profile, bans, level, owned games, CS2 lifetime stats, friends, friend code, Game Coordinator data (commendations, profile rank, badges), CS2 inventory summary, Faceit and Leetify.

OpenAPI 3.1 llms.txt
HTTP ENDPOINT

Endpoint URI

GET/api/profile/{id}

Full example URL: https://cs2.space/api/profile/ChetCS

PARAMETERS

Path parameters

idSTRINGREQUIRED

SteamID64 (17 digits, e.g. 76561197963540638) or custom profile URL name (e.g. ChetCS).

PARAMETERS

Query parameters

includeSTRING

Extra data to add. dota2 adds a dota2Inventory field: the player's Dota 2 inventory, most valuable items first, with totals for the whole inventory (same shape as the Dota 2 inventory endpoint). PRO and DEVELOPER plans.Values:dota2

dota2LimitSTRING

With include=dota2: how many items to return, as a number or all. Large inventories with all can be several MB.Default: 200

BEHAVIOR

Implementation notes

  • FREE keys get Steam profile data only: faceit, leetify and steam.inventory are null and a _notice field explains how to upgrade.
  • faceit is null when the player has no Faceit account; leetify is null when they have no Leetify profile.
  • leetify.avatar provides the player's Leetify profile picture URL, a Leetify-generated placeholder (a dicebear.com URL, or https://leetify.com/assets/images/anon.png for players not signed up to Leetify) if unset, or null when unavailable.
  • leetifyStatus indicates the freshness of the leetify field: 'fresh' | 'cached' | 'stale' | 'none' | 'unavailable' | 'deferred'.
  • steam.stats is a list of {name, value} pairs from Steam's CS2 stats (total_kills, total_wins, ...).
  • Badge imageUrl values are full links you can use directly in an <img>.
  • Profile data is cached for up to 3 hours; inventory prices are always current.
USAGE

Example request

curl -H "x-api-key: YOUR_KEY" "https://cs2.space/api/profile/ChetCS"
PAYLOAD

Example response

RESPONSE · 200 OK · long arrays shortened to one entry
{  "steamId": "76561197963540638",  "steam": {    "player": {      "steamid": "76561197963540638",      "personaname": "Chet",      "profileurl": "https://steamcommunity.com/id/ChetCS/",      "avatarfull": "https://avatars.steamstatic.com/7eff590c73206f7f0bb6bfbbf9fd3f3e46c95826_full.jpg",      "timecreated": 1072291152,      "communityvisibilitystate": 3    },    "bans": {      "SteamId": "76561197963540638",      "CommunityBanned": false,      "VACBanned": false,      "NumberOfVACBans": 0,      "DaysSinceLastBan": 0,      "NumberOfGameBans": 0,      "EconomyBan": "none"    },    "level": 70,    "games": [      {        "appid": 10,        "playtime_forever": 45104      }    ],    "stats": [      {        "name": "total_kills",        "value": 99648      },      {        "name": "total_deaths",        "value": 81581      },      {        "name": "total_time_played",        "value": 5582556      }    ],    "friends": [      {        "steamid": "76561190000000000",        "relationship": "friend",        "friend_since": 1550022592      }    ],    "friendCode": "AYR6T-HGDA",    "gc": {      "commendations": {        "friendly": 118,        "teacher": 82,        "leader": 80      },      "playerLevel": 18,      "playerCurXp": 327683388,      "badges": [        {          "name": "Premier Season Four Medal",          "image": "/badges/badge_premier_season_four_medal_125_wins_15_000_19_999_cs_rating_.png",          "rarity": "Extraordinary",          "imageUrl": "https://cs2.space/api/assets/badges/badge_premier_season_four_medal_125_wins_15_000_19_999_cs_rating_.png"        }      ],      "featuredBadge": {        "name": "Premier Season Four Medal",        "image": "/badges/badge_premier_season_four_medal_125_wins_15_000_19_999_cs_rating_.png",        "rarity": "Extraordinary",        "imageUrl": "https://cs2.space/api/assets/badges/badge_premier_season_four_medal_125_wins_15_000_19_999_cs_rating_.png"      }    },    "coinsAndPins": [      {        "name": "Premier Season Four Medal",        "image": "https://community.cloudflare.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGJWk3ka5VeTr0M-gJnSZ9hll5oL541z1fg70n4Xv8x0P0PGhYapSdKXdWzLGkOt15-QxHi_ql0ly5DmHnN-hJC2RPVJxWcB4QbZY4Riwk4HjNfSiuVKLPsh8JA"      }    ],    "inventory": {      "summary": {        "totalCount": 505,        "tradableCount": 473,        "totalValue": 1530.62,        "totalValueFormatted": "$1,530.62"      },      "pagination": {        "total": 505,        "limit": 200,        "offset": 0,        "hasMore": true      }    }  },  "faceit": {    "player_id": "3699c7a1-7ee1-4c2d-bcca-49fdb2071a4e",    "nickname": "aimbotthot1",    "country": "us",    "faceit_url": "https://www.faceit.com/{lang}/players/aimbotthot1",    "games": {      "cs2": {        "region": "NA",        "skill_level": 4,        "faceit_elo": 1018,        "game_player_id": "76561197963540638"      }    }  },  "leetify": {    "name": "Chet",    "steam64_id": "76561197963540638",    "avatar": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/59/590cec88b7cb47417e19c19058cb4f95b364f59d_full.jpg",    "first_match_date": "2020-08-01T22:09:58.000Z",    "total_matches": 2265,    "winrate": 0.3,    "rating": {      "aim": 48.4047,      "positioning": 52.3922,      "utility": 38.4005,      "clutch": 0.0672,      "opening": -0.0084,      "ct_leetify": -0.0103,      "t_leetify": -0.0054    },    "ranks": {      "leetify": -0.77,      "premier": 15960,      "faceit": null,      "faceit_elo": null,      "wingman": 7,      "renown": null,      "competitive": [        {          "map_name": "de_dust2",          "rank": 10        }      ]    },    "stats": {      "accuracy_head": 26.7328,      "reaction_time_ms": 595.9576,      "preaim": 10.765,      "spray_accuracy": 24.8483    },    "recent_matches": [      {        "id": "ba2a8847-0c8c-4be7-97e2-69d9dd67e733",        "finished_at": "2026-09-30T21:10:47.000Z",        "data_source": "matchmaking",        "outcome": "win",        "map_name": "de_cache",        "score": [          13,          2        ],        "leetify_rating": 0.0279,        "rank": 15960      }    ]  },  "leetifyStatus": "fresh"}
TROUBLESHOOTING

Status codes

401 UnauthorizedNo API key was sent.
{
  "error": "API key required"
}
403 ForbiddenInvalid API key, the player's inventory is private (code INVENTORY_PRIVATE), or the endpoint needs a PRO or DEVELOPER plan (code PLAN_UPGRADE_REQUIRED).
{
  "error": "Inventory data requires a PRO or DEVELOPER plan.",
  "code": "PLAN_UPGRADE_REQUIRED",
  "upgradeUrl": "https://cs2.space/#pricing"
}
404 Not FoundThe SteamID or profile name doesn't match a player.
{
  "error": "Player not found",
  "code": "PLAYER_NOT_FOUND"
}
429 Too Many RequestsRate limit or monthly quota exceeded, or Steam is rate limiting inventory requests (code STEAM_RATE_LIMIT). Retry later.
{
  "error": "Monthly API quota exceeded",
  "tier": "FREE",
  "limit": 500,
  "usage": 500,
  "message": "Please upgrade your plan or wait for next month's reset."
}
500 Internal Server ErrorSomething went wrong on our side.
{
  "error": "Internal Server Error"
}

See all error responses on the Errors reference page.

Was this page helpful?
← PREVIOUS PAGE
Authentication
NEXT PAGE →
Resolve a SteamID

Ready to build?

GET YOUR FREE KEY NOW →