Steam Inventory API: Fetch Your CS2 Items

The Steam Inventory API lets you retrieve live CS2 inventory data directly from Steam. You can fetch your own inventory using your linked Steam account, or look up any player’s public inventory by their Steam64 ID or vanity URL. Inventory data is fetched live on every request and is never stored by CS2Cap.

GET /inventory/steam

Returns the authenticated user’s live CS2 inventory from Steam. A linked Steam account is required — connect yours in your account settings before calling this endpoint. Auth: Bearer token + linked Steam account

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/inventory/steam"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.InventoryApi(client)
    response = api.get_steam_inventory()

print(client.sanitize_for_serialization(response))

import { Configuration, InventoryApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new InventoryApi(new Configuration({ accessToken }));
const response = await api.getSteamInventory();

console.log(response);

Response example

{
  "data": [
    {
      "assetid": "12345678901234567",
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "name": "AK-47 | Redline",
      "icon_url": "https://steamcommunity-a.akamaihd.net/economy/image/...",
      "tradable": true,
      "marketable": true,
      "quantity": 1,
      "float_value": 0.234512,
      "paint_seed": 123,
      "inspect_link": "steam://rungame/730/...",
      "name_tag": "Collector's piece",
      "stickers": [],
      "charms": []
    }
  ],
  "total_count": 1
}

data[].assetid

string

Steam asset ID for this specific instance of the item. Unique within the inventory.

data[].market_hash_name

string

Full item name as it appears in the Steam market catalog.

data[].phase

string | null

Doppler/Gamma phase for phase-variant items, or null.

data[].name

string

Display name without wear condition.

data[].icon_url

string

Steam CDN URL for the item’s inventory icon.

data[].tradable

boolean

Whether the item can currently be traded on Steam.

data[].marketable

boolean

Whether the item can be listed on the Steam Community Market.

data[].quantity

integer

Number of this item in the stack. Almost always 1 for CS2 items.

data[].float_value

number | null

Wear float value (0.0–1.0) for weapon skins. null for non-weapon items.

data[].paint_seed

integer | null

Pattern seed for weapon skins. null for items without a pattern.

data[].inspect_link

string | null

Steam inspect link for viewing the item in-game. null for items that do not support inspection.

data[].name_tag

string | null

Custom name tag applied to the item, or null.

data[].stickers

array | null

Applied stickers. null when the item has none.

data[].charms

array | null

Applied charms. null when the item has none.

total_count

integer

Total number of items Steam reported in the inventory.

This endpoint fetches live data on each call. Nothing is persisted by CS2Cap. stickers and charms may be null when an item has none applied.

GET /inventory/steam/lookup

Returns the live CS2 inventory for any Steam account. You can identify the target by their 17-digit Steam64 ID or their vanity URL name. Auth: Bearer token

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/inventory/steam/lookup?steam_id=anomaly"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.InventoryApi(client)
    response = api.get_steam_inventory_by_steam_id(
        steam_id="anomaly"
    )

print(client.sanitize_for_serialization(response))

import { Configuration, InventoryApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const api = new InventoryApi(new Configuration({ accessToken }));
const response = await api.getSteamInventoryBySteamId({ steamId: "76561198000000000" });

console.log(response);

steam_id

string

required

17-digit Steam64 ID (e.g., 76561198012345678) or vanity URL name (e.g., myusername). The vanity URL name is the custom part of a Steam profile URL.

Response example

{
  "data": [
    {
      "assetid": "12345678901234567",
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "phase": null,
      "name": "AK-47 | Redline",
      "icon_url": "https://steamcommunity-a.akamaihd.net/economy/image/...",
      "tradable": true,
      "marketable": true,
      "quantity": 1,
      "float_value": 0.234512,
      "paint_seed": 123,
      "inspect_link": "steam://rungame/730/...",
      "name_tag": null,
      "stickers": null,
      "charms": null
    }
  ],
  "total_count": 1
}

The response format is identical to GET /inventory/steam. See that endpoint’s response field definitions above.

Overview

Market Data

Analytics

Portfolio

Account

Steam Inventory API: Fetch Your CS2 Items

GET /inventory/steam

GET /inventory/steam/lookup

​GET /inventory/steam

​GET /inventory/steam/lookup

GET /inventory/steam

GET /inventory/steam/lookup