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

CS2 inventory

GETx-api-key requiredPRO & DEVELOPER

A player's Counter-Strike 2 inventory, parsed: category, rarity, exterior, exact float and pattern seed, stickers, StatTrak/Souvenir, trade lock, working inspect link and USD price for every item.

OpenAPI 3.1 llms.txt
HTTP ENDPOINT

Endpoint URI

GET/api/inventory/{id}

Full example URL: https://cs2.space/api/inventory/76561198074762801?category=knives&sort=price_desc&limit=1

PARAMETERS

Path parameters

idSTRINGREQUIRED

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

PARAMETERS

Query parameters

categorySTRING

Only return one category.Values:knivesglovesriflessniper_riflespistolssmgsshotgunsmachinegunscasesstickersagentsmusic_kitspins_coinspatchesgraffitiother

sortSTRING

Sort order. Default is Steam's inventory order.Values:price_descprice_ascname_asc

limitINTEGER

Items per page, 1 to 1000.Default: 100

offsetINTEGER

Number of items to skip.Default: 0

freshBOOLEAN

PRO and DEVELOPER keys only: skip the 30 minute cache and fetch from Steam.Default: false

BEHAVIOR

Implementation notes

  • Prices are USD market prices, refreshed every 15 minutes. Items with no active market have price: null.
  • Doppler-style items whose phase isn't exposed are valued at the cheapest phase.
  • summary always describes the whole inventory; pagination.total counts items after the category filter.
  • Inventories are cached for 30 minutes (cached and cachedAt tell you when the data is from).
USAGE

Example request

curl -H "x-api-key: YOUR_KEY" "https://cs2.space/api/inventory/76561198074762801?category=knives&sort=price_desc&limit=1"
PAYLOAD

Example response

RESPONSE · 200 OK · long arrays shortened to one entry
{  "steamId": "76561198074762801",  "steamInventoryUrl": "https://steamcommunity.com/profiles/76561198074762801/inventory/",  "summary": {    "totalCount": 474,    "tradableCount": 433,    "statTrakCount": 33,    "souvenirCount": 12,    "totalValue": 42995.38,    "totalValueFormatted": "$42,995.38",    "categoryCounts": {      "smgs": 16,      "gloves": 5,      "cases": 5,      "knives": 14,      "rifles": 18,      "pins_coins": 82,      "pistols": 96,      "other": 11,      "stickers": 187,      "sniper_rifles": 15,      "shotguns": 7,      "music_kits": 13,      "agents": 5    },    "rarityCounts": {      "Mil-Spec Grade": 88,      "Extraordinary": 54,      "Base Grade": 10,      "Covert": 24,      "Restricted": 24,      "Classified": 18,      "Industrial Grade": 10,      "High Grade": 185,      "Remarkable": 39,      "Exotic": 10,      "Consumer Grade": 3,      "Master": 3,      "Stock": 4,      "Exceptional": 2    }  },  "items": [    {      "assetId": "41918635414",      "classId": "7993042582",      "instanceId": "188530139",      "amount": 1,      "name": "★ Butterfly Knife | Fade",      "marketName": "★ Butterfly Knife | Fade (Factory New)",      "marketHashName": "★ Butterfly Knife | Fade (Factory New)",      "type": "★ Covert Knife",      "category": "knives",      "rarity": {        "name": "Covert",        "color": "#eb4b4b"      },      "exterior": "Factory New",      "weapon": "Butterfly Knife",      "itemSet": "The Breakout Collection",      "iconUrl": "https://community.cloudflare.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1w...",      "iconUrlLarge": null,      "isStatTrak": false,      "isSouvenir": false,      "tradable": true,      "marketable": true,      "tradableAfter": null,      "inspectLink": "steam://run/730//+csgo_econ_action_preview%20A7B7311C09333BA6BF24A387818FA197A49F7E127145A4E732A2CF27A5D7AF184F3356",      "floatValue": 0.013037406839430332,      "paintSeed": 661,      "steamInventoryUrl": "https://steamcommunity.com/profiles/76561198074762801/inventory/#730_2_41918635414",      "nameTag": null,      "stickers": [],      "price": {        "amount": 2566.68,        "formatted": "$2566.68",        "currency": "USD"      }    }  ],  "pagination": {    "total": 14,    "limit": 1,    "offset": 0,    "hasMore": true  },  "cached": true,  "cachedAt": "2026-10-02T03:00:44.103Z",  "stale": false}
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."
}
502 Bad GatewaySteam failed to return the inventory. Retry shortly.
{
  "error": "Failed to load inventory from Steam. Please retry shortly."
}

See all error responses on the Errors reference page.

Was this page helpful?
← PREVIOUS PAGE
Resolve a SteamID
NEXT PAGE →
CS2 inventory summary

Ready to build?

GET YOUR FREE KEY NOW →