Base URL: https://cs2.space
CS2 inventory (raw Steam data)
GETx-api-key requiredPRO & DEVELOPER
The unparsed inventory payload (assets, descriptions, asset_properties) with every page combined, for when you want the original fields.
HTTP ENDPOINT
Endpoint URI
Full example URL: https://cs2.space/api/inventory/76561198074762801/raw
PARAMETERS
Path parameters
idSTRINGREQUIREDSteamID64 (17 digits, e.g. 76561197963540638) or custom profile URL name (e.g. ChetCS).
BEHAVIOR
Implementation notes
- Cached for 30 minutes.
USAGE
Example request
curl -H "x-api-key: YOUR_KEY" "https://cs2.space/api/inventory/76561198074762801/raw"PAYLOAD
Example response
RESPONSE · 200 OK · long arrays shortened to one entry
{ "success": 1, "assets": [ { "appid": 730, "contextid": "2", "assetid": "53419434826", "classid": "188530159", "instanceid": "188530139", "amount": "1" } ], "descriptions": [ { "appid": 730, "classid": "188530159", "instanceid": "188530139", "name": "MP7 | Skulls", "market_name": "MP7 | Skulls (Minimal Wear)", "market_hash_name": "MP7 | Skulls (Minimal Wear)", "type": "Mil-Spec Grade SMG", "tradable": 1, "marketable": 1, "icon_url": "i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60...", "tags": [ { "category": "Type", "internal_name": "CSGO_Type_SMG", "localized_category_name": "Type", "localized_tag_name": "SMG" }, { "category": "Weapon", "internal_name": "weapon_mp7", "localized_category_name": "Weapon", "localized_tag_name": "MP7" } ] } ], "asset_properties": [ { "appid": 730, "contextid": "2", "assetid": "53419434826", "asset_properties": [ { "propertyid": 1, "int_value": "996", "name": "Pattern Template" }, { "propertyid": 2, "float_value": "0.118721641600131989", "name": "Wear Rating" }, { "propertyid": 6, "string_value": "2636ECE089A6E1273E07062D0E2516221EF3EEEAC92566C2214E63562E725EC76B", "name": "Item Certificate" } ] } ], "total_inventory_count": 474}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.