|
key
Required
query • string
|
Your API key for authentication. Required for all requests.
Get your API key from Dashboard โ Top-right corner โ API Key section.
|
|
game
query • string
|
Game identifier. Each game has different item properties and markets.
**Supported games:**
- `cs2` (default): Counter-Strike 2 - Full support including real market prices
- `rust`: Rust - Basic Steam market data
- `dota`: Dota 2 - Basic Steam market data
- `tf2`: Team Fortress 2 - Basic Steam market data
|
|
page
query • integer
|
Page number for pagination. Use with `max` parameter.
- Page 1 returns items 1-50000 (with default max)
- Page 2 returns items 50001-100000, etc.
|
|
max
query • integer
|
Maximum number of items per page. Lower values improve response time.
**Recommendations:**
- Use 100-1000 for web applications
- Use higher values for data exports
- Maximum: 50000 items per request
Example:
100
|
|
sort_by
query • string
|
Sorting order for results.
โ ๏ธ **Performance Note:** Sorting can significantly slow down responses for large result sets. Use filters (`price_min`, `item_group`, etc.) to reduce data before sorting, or use the default `priceAz` for best performance.
**Price-based sorting:**
- `priceAz` (default): Steam listing price ascending (cheapest first) - *Fastest*
- `priceZa`: Steam listing price descending (most expensive first)
- `priceRealAz`: Third-party market price ascending
- `priceRealZa`: Third-party market price descending
**Win/Loss sorting** (Steam vs. Market price comparison):
- `winner`: Best deals first (Steam cheaper than markets)
- `loser`: Worst deals first (Steam more expensive)
- `winLossAz`: Win/loss ascending
- `winLossZa`: Win/loss descending
- `winnerRandom`: Winners first, randomized within group
- `loserRandom`: Losers first, randomized within group
**Volume-based sorting:**
- `soldAz`: Least sold items first
- `soldZa`: Most sold items first (popular items)
- `pointsAz`: Lowest market cap first
- `pointsZa`: Highest market cap first
**Other:**
- `name`: Alphabetical by market hash name
- `random`: Random order (useful for discovery) - *Slowest*
|
|
search
query • string
|
Search items by name. Minimum 3 characters required.
**Examples:**
- `search=AK-47` - Find all AK-47 skins
- `search=Doppler` - Find all Doppler items (knives, gloves)
- `search=Redline` - Find Redline skins across all weapons
Search is case-insensitive and matches partial names.
|
|
price_min
query • number
|
Minimum Steam Market listing price in USD.
- Items below this price will be excluded
- Use with `price_max` to define a price range
- Prices are in the base currency (USD) unless `currency` is specified
|
|
price_max
query • number
|
Maximum Steam Market listing price in USD.
- Items above this price will be excluded
- Steam Market maximum is ~$3000 (varies by region)
- Use with `price_min` to define a price range
|
|
price_real_min
query • number
|
Minimum third-party market price in USD.
- Filters by the lowest available price across all third-party markets
- Useful for finding arbitrage opportunities
|
|
price_real_max
query • number
|
Maximum third-party market price in USD.
- Filters by the lowest available price across all third-party markets
- High-value items may exceed Steam Market limits ($3000)
|
|
item_group
query • string
|
Filter by item category/group.
**CS2 groups:**
- `knife` - All knives (Karambit, Butterfly, etc.)
- `gloves` - All gloves
- `pistol` - Pistols (Glock, USP-S, Desert Eagle, etc.)
- `rifle` - Rifles (AK-47, M4A1-S, etc.)
- `sniper rifle` - Sniper rifles (AWP, SSG 08, etc.)
- `smg` - SMGs (MP9, MAC-10, etc.)
- `shotgun` - Shotguns
- `machinegun` - Machine guns (M249, Negev)
- `case` - Weapon cases
- `capsule` - Sticker capsules
- `collection` - Collections
Multiple groups: `knife,gloves` (comma-separated)
|
|
item_type
query • string
|
Filter by specific weapon type within a group.
**Examples:**
- `ak-47` - Only AK-47 skins
- `awp` - Only AWP skins
- `karambit` - Only Karambit knives
- `m4a1-s` - Only M4A1-S skins
Use `/steam/api/info/items?type=types` to get all available types.
|
|
item_name
query • string
|
Filter by skin name (without weapon type).
**Examples:**
- `redline` - All Redline skins (AK-47, AWP, etc.)
- `doppler` - All Doppler items
- `asiimov` - All Asiimov skins
- `fade` - All Fade items
Use `/steam/api/info/items?type=items` to get all available names.
|
|
wear
query • string
|
Filter by item condition/wear level.
**Wear levels:**
- `fn` - Factory New (0.00 - 0.07 float)
- `mw` - Minimal Wear (0.07 - 0.15 float)
- `ft` - Field-Tested (0.15 - 0.38 float)
- `ww` - Well-Worn (0.38 - 0.45 float)
- `bs` - Battle-Scarred (0.45 - 1.00 float)
Multiple wears: `fn,mw` (comma-separated)
|
|
select
query • string
|
Select specific fields to return. Dramatically reduces response size.
**Example:** `select=markethashname,pricelatest,image`
**Popular field selections:**
- Basic: `markethashname,pricelatest,image`
- Trading: `markethashname,pricelatest,pricereal,winloss`
- Full price: `markethashname,pricelatest,pricereal,buyorderprice,sold24h`
Field names must match exact response field names (lowercase).
|
|
currency
query • string
|
Convert prices to specified currency.
**Supported currencies:**
- `USD` (default), `EUR`, `GBP`, `TRY`, `RUB`, `CNY`, `JPY`, `BRL`, `PLN`, `CAD`, `AUD`
Conversion rates are updated hourly from Steam.
|
|
production
query • string
|
Set to `1` when using in production environment.
**Benefits:**
- Removes info/hint fields from response
- Cleaner, smaller response payload
- Will be required in future API versions
**Note:** If not set, you may see deprecation warnings.
|
|
format
query • string
|
Output format for the response.
**JSON formats:**
- `json` (default): Standard JSON
- `gzip`: Gzip-compressed JSON
- `zip`: Zip-compressed JSON
- `ndjson`: Newline-delimited JSON (streaming)
**Export formats:**
- `csv`: Comma-separated values
- `xml`: XML format
- `html`: HTML table
**Database formats:**
- `mysql`: MySQL INSERT statements
- `mysql_with_table`: MySQL with CREATE TABLE
- `pgsql`: PostgreSQL INSERT statements
- `pgsql_with_table`: PostgreSQL with CREATE TABLE
- `mongo`: MongoDB insert documents
|
|
pretty
query • string
|
Pretty-print JSON output (indented, human-readable).
- `0` (default): Minified JSON (smaller size)
- `1`: Formatted JSON (easier to read)
Only applies to json, gzip, and zip formats.
|
|
markets
query • string
|
Filter third-party market prices to specific markets only.
**Available markets:**
- `skinbaron` - Skinbaron.de
- `skinport` - Skinport.com
- `dmarket` - DMarket.com
- `buff` - Buff163.com
- `waxpeer` - Waxpeer.com
- `bitskins` - BitSkins.com
- `csgotm` - CS.Money / CSGOTradeMoney
- `haloskins` - HaloSkins
- `tradeit` - Tradeit.gg
- `skinbid` - Skinbid.com
**Example:** `markets=skinbaron,buff,skinport`
When specified, `pricereal` will be the lowest price among selected markets only.
|
|
with_preview_items
query • boolean
|
Append newly discovered items that are not yet fully indexed.
- `0` or `false` (default): Only return fully indexed items
- `1` or `true`: Append preview items at the end
Preview items have:
- `preview: true` flag
- Limited data (no prices, basic metadata only)
- 24-hour cache
Useful for discovering new items before they appear in main listings.
|