REST
Search Items
Search for items by name across marketplaces, returning a lightweight list of matches.
Endpoint
Searches for items by name and returns a lightweight list of matches. Useful for autocomplete and for discovering the exact market name to pass to Get Item.
GET /v2/items/search
Query parameters
game
string
Game code (e.g.
CS2, Dota2, Rust, TF2).query
string
Search string to match against item names.
marketplace
string
Optional marketplace filter. Omit to search across all marketplaces.
limit
number
Maximum number of results to return. Defaults to
100.Authentication
See REST overview for base URL, authentication, and error shape.
Response fields
The response is an array of item summary objects.
| Field | Type | Description |
|---|---|---|
name | string | Item market name |
marketplace | string | Marketplace the item is listed on |
game | string | Game the item belongs to |
priceUSD | number|null | Lowest offer price in USD |
offerCount | number | Number of open offers |
thumbnail | string|null | URL to the item thumbnail image |
updatedAt | number | Unix timestamp of last update |
Response example
response.json
[
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"offerCount": 128,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
},
{
"name": "AK-47 | Redline (Minimal Wear)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 78.20,
"offerCount": 42,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
}
]