Explore everypublic endpoint.

Returns exactly one Steam page. A successful normal public request consumes one base credit and may use a fresh or stale-if-error public snapshot. no_cache=true, caller-supplied steam_login_secure or trade_url credentials, and try_first_seven_days_blocked_items=true each add +1 credit when the result is billable because they force a fresh fetch. Fresh-fetch additions never stack, so the maximum billable inventory-request price is 2 credits. Steam's undocumented Community inventory endpoint currently returns HTTP 401 with JSON null for structurally valid but unallocated SteamID64 values. Because 401 may also represent a public-empty state, ItemData treats it as a successful empty public page and follows normal public-page caching and billing. An upstream Steam HTTP 403 is treated as a confirmed private inventory and finalizes the full quote: 1 credit for a normal MISS or private-marker HIT, or 2 credits for a fresh-fetch mode. It is cached for 72 hours once per SteamID64; during that TTL it applies to every game and normal requests return HIT without contacting Steam. no_cache=true ignores both public snapshots and the private marker, charges 2 credits for a confirmed fresh 403, and refreshes the marker. A non-authoritative success=false result still removes an older public snapshot but is not charged. Caller-supplied and internal Steam-session requests always perform a fresh fetch and bypass all shared cache state. For an authorized account, provide a structurally valid steamLoginSecure cookie in X-Steam-Login-Secure to fetch the cookie owner's inventory for any supported game; for CS2, this avoids the normal 10-day visibility delay. steam_id is ignored and the owner SteamID64 is read from the cookie. Alternatively, provide a canonical Steam trade URL in X-Steam-Trade-URL to fetch that CS2 partner inventory, including 7-10 day trade-locked items; steam_id is then ignored and the target is read from the URL. If both credentials are present, X-Steam-Login-Secure takes precedence and the trade URL is ignored. Never put either secret in a URL unless legacy compatibility is unavoidable: query strings can enter browser history, access logs, and intermediary logs. Set try_first_seven_days_blocked_items=true for CS2 to try the internal partner-inventory session pool first; this forces non-tradable items to be included and falls back to a fresh public inventory request on the first page only when Steam rejects the partner request or the pool is temporarily unavailable. trade_url cannot be combined with try_first_seven_days_blocked_items. Broker authentication/configuration and invalid broker responses fail instead of being hidden by public fallback. Other failed requests and non-authoritative success=false responses consume zero credits. The upstream public Steam page size is fixed server-side at 2000; count and limit are not accepted. When more_items is true, pass last_assetid as start_assetid on the next request. Preserve cursor provenance using X-ItemData-Inventory-Source: keep the option enabled after partner, but omit it after public-fallback. The actual encoded JSON body is limited to 12 MiB for both compact and pretty output.

Authentication

Bearer API key or legacy query keyOperation ID: getInventory

Credits

1–2 creditsSuccessful normal pages cost 1 credit. Any fresh-fetch mode adds +1, and fresh options never stack above 2 credits.

Rate limit

Plan limitsThe active plan's minute, day, and month request limits apply before Steam work begins.

curl --fail-with-body --get \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $ITEMDATA_API_KEY" \
  --data-urlencode 'steam_id=76561198000000000' \
  --data-urlencode 'game=cs2' \
  'https://itemdata.net/v1/inventory'

import os
import requests

payload = {
    "key": os.environ["ITEMDATA_API_KEY"],
    "steam_id": "76561198000000000",
    "game": "cs2",
}

response = requests.get(
    "https://itemdata.net/v1/inventory",
    params=payload,
    timeout=30
)
response.raise_for_status()
print(response.json())

const params = new URLSearchParams({
  "steam_id": "76561198000000000",
  "game": "cs2",
});

const response = await fetch(`https://itemdata.net/v1/inventory?${params}`, {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": `Bearer ${process.env.ITEMDATA_API_KEY}`,
  },
});

if (!response.ok) {
  throw new Error(`ItemData request failed: ${response.status}`);
}

console.log(await response.json());

{
  "success": true,
  "steam_id": "76561198000000000",
  "game": "cs2",
  "appid": 730,
  "total_inventory_count": 184,
  "items": [
    {
      "assetid": "34589211402",
      "market_hash_name": "AK-47 | Slate (Field-Tested)",
      "tradable": true
    }
  ],
  "last_assetid": "34589211402",
  "more_items": true
}

Returns the currently published ItemData plans, credit balances, and minute, day, and month request limits without requiring an API key.

Authentication

NoneOperation ID: listPublishedPlans

Credits

FreeThis endpoint does not consume inventory credits.

Rate limit

Public readProtected by bounded service capacity; no API key is required.

curl --fail-with-body --get \
  -H 'Accept: application/json' \
  'https://itemdata.net/v1/plans'

import requests

response = requests.get(
    "https://itemdata.net/v1/plans",
    timeout=30
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://itemdata.net/v1/plans", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});

if (!response.ok) {
  throw new Error(`ItemData request failed: ${response.status}`);
}

console.log(await response.json());

Reports dependency-aware service readiness, including the runtime components required to serve inventory traffic.

Authentication

NoneOperation ID: getHealth

Credits

FreeThis endpoint does not consume inventory credits.

Rate limit

Health probeIntended for dependency-aware health and status checks.

curl --fail-with-body --get \
  -H 'Accept: application/json' \
  'https://itemdata.net/v1/health'

import requests

response = requests.get(
    "https://itemdata.net/v1/health",
    timeout=30
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://itemdata.net/v1/health", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});

if (!response.ok) {
  throw new Error(`ItemData request failed: ${response.status}`);
}

console.log(await response.json());

Confirms that the ItemData HTTP process is running. This lightweight probe does not verify downstream dependencies.

Authentication

NoneOperation ID: getLiveness

Credits

FreeThis endpoint does not consume inventory credits.

Rate limit

Health probeIntended for lightweight process-liveness checks.

curl --fail-with-body --get \
  -H 'Accept: application/json' \
  'https://itemdata.net/v1/live'

import requests

response = requests.get(
    "https://itemdata.net/v1/live",
    timeout=30
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://itemdata.net/v1/live", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});

if (!response.ok) {
  throw new Error(`ItemData request failed: ${response.status}`);
}

console.log(await response.json());

Returns the backend's embedded, English-language OpenAPI documentation for human inspection.

Authentication

NoneOperation ID: getEmbeddedDocumentation

Credits

FreeThis endpoint does not consume inventory credits.

Rate limit

Public referenceServed as a short-lived cacheable documentation response.

curl --fail-with-body --get \
  'https://itemdata.net/v1/docs'

import requests

response = requests.get(
    "https://itemdata.net/v1/docs",
    timeout=30
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://itemdata.net/v1/docs", {
  method: "GET",
});

if (!response.ok) {
  throw new Error(`ItemData request failed: ${response.status}`);
}

console.log(await response.text());

Returns the authoritative English-language OpenAPI 3.0 YAML contract used to generate the public endpoint catalog.

Authentication

NoneOperation ID: getOpenAPIContract

Credits

FreeThis endpoint does not consume inventory credits.

Rate limit

Public referenceServed as a short-lived cacheable machine-readable contract.

curl --fail-with-body --get \
  -H 'Accept: application/yaml' \
  'https://itemdata.net/v1/openapi.yaml'

import requests

response = requests.get(
    "https://itemdata.net/v1/openapi.yaml",
    timeout=30
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://itemdata.net/v1/openapi.yaml", {
  method: "GET",
  headers: {
    "Accept": "application/yaml",
  },
});

if (!response.ok) {
  throw new Error(`ItemData request failed: ${response.status}`);
}

console.log(await response.text());