Player profile
GET
/api/profile/{id}API key requiredEverything 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.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | SteamID64 (17 digits, e.g. 76561197963540638) or custom profile URL name (e.g. ChetCS). |
include | query | string | No | 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. One of: dota2. |
dota2Limit | query | string | No | With include=dota2: how many items to return, as a number or all. Large inventories with all can be several MB. Default: 200. |
- 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.
REQUEST
curl -H "x-api-key: YOUR_KEY" "https://cs2.space/api/profile/ChetCS"RESPONSE · 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"
}
