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/v1/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;

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
}

string

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

string

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

string | null

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

string

Display name without wear condition.

string

Steam CDN URL for the item’s inventory icon.

boolean

Whether the item can currently be traded on Steam.

boolean

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

integer

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

number | null

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

integer | null

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

string | null

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

string | null

Custom name tag applied to the item, or null.

array | null

Applied stickers. null when the item has none.

array | null

Applied charms. null when the item has none.

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/v1/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;

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

console.log(response);

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

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