Get trading items by class id or app
Returns trading items: cards, foils, booster packs, backgrounds and emoticons.
Request
Send one of:
classIds: up to 100 Steam class ids. Items come back in request order.appIds: up to 10 apps. Every item of each app comes back.
Ids that match no item are in missing.classIds or missing.appIds.
Freshness
Items follow steamsets.com within about a minute.
Cost
Each item returned and each id that matches nothing uses one unit of the key’s 20,000 daily units.
Example
{
"items": [
{
"classId": 667924416,
"app": { "appId": 730, "name": "Counter-Strike 2" },
"name": "Phoenix",
"kind": "card",
"isFoil": false,
"isMarketable": true,
"priceCents": 9
}
],
"missing": { "classIds": [], "appIds": [] }
}
/v1/item.getAuthorizationBearer token · headerrequiredapplication/jsonappIdsinteger<int32>[] | nullSteam app ids. Returns every item of each app: cards, foils, booster packs, backgrounds and emoticons. Send classIds or appIds, not both.
classIdsinteger<int64>[] | nullSteam class ids, as in an inventory's classid. Send classIds or appIds, not both.
OK
itemsItemGetItem[]requiredIn request order for classIds, by app for appIds.
Show propertiesHide properties
ItemGetItemappItemGetApprequiredShow propertiesHide properties
appIdinteger<int32>requirednamestringrequiredclassIdinteger<int64>required0 for a card that has never been on the Steam market.
gemsinteger<int32>requiredGems the item turns into.
isFoilbooleanrequiredisMarketablebooleanrequiredkindstringrequiredcardmysteryCardboosterPackbackgroundemoticonotherlastSoldAtstring<date-time>Last Steam market sale. Missing when none is known.
namestringrequiredpointsinteger<int32>requiredPoints Shop price in points, 0 when the Points Shop does not sell it.
priceCentsinteger<int32>requiredCheapest Steam market listing in US cents, 0 when there is none.
rarityinteger<int32>requiredBooster drop rarity of a background or emoticon: 0 common, 1 uncommon, 2 rare.
missingItemGetMissingrequiredThe ids that matched no item, by id kind.
Show propertiesHide properties
appIdsinteger<int32>[]requiredThe requested app ids that have no items.
classIdsinteger<int64>[]requiredThe requested class ids that match no item.
Bad Request
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Unauthorized
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Unprocessable Entity
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Too Many Requests
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Internal Server Error
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.