Skip to content
SteamSets
Esc
↑↓navigate↵open⌘Jpreview

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": [] }
}
POST/v1/item.get
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
appIdsinteger<int32>[] | null

Steam app ids. Returns every item of each app: cards, foils, booster packs, backgrounds and emoticons. Send classIds or appIds, not both.

max items 10
classIdsinteger<int64>[] | null

Steam class ids, as in an inventory's classid. Send classIds or appIds, not both.

max items 100
Responses
200

OK

itemsItemGetItem[]required

In request order for classIds, by app for appIds.

Show properties
Array of ItemGetItem
appItemGetApprequired
Show properties
appIdinteger<int32>required
min 0
namestringrequired
classIdinteger<int64>required

0 for a card that has never been on the Steam market.

min 0
gemsinteger<int32>required

Gems the item turns into.

min 0
isFoilbooleanrequired
isMarketablebooleanrequired
kindstringrequired
Allowed:cardmysteryCardboosterPackbackgroundemoticonother
lastSoldAtstring<date-time>

Last Steam market sale. Missing when none is known.

namestringrequired
pointsinteger<int32>required

Points Shop price in points, 0 when the Points Shop does not sell it.

min 0
priceCentsinteger<int32>required

Cheapest Steam market listing in US cents, 0 when there is none.

min 0
rarityinteger<int32>required

Booster drop rarity of a background or emoticon: 0 common, 1 uncommon, 2 rare.

min 0
missingItemGetMissingrequired

The ids that matched no item, by id kind.

Show properties
appIdsinteger<int32>[]required

The requested app ids that have no items.

classIdsinteger<int64>[]required

The requested class ids that match no item.

400

Bad Request

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
429

Too Many Requests

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST 'https://api.steamsets.com/v1/item.get' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "appIds": [
    730
  ],
  "classIds": [
    667924416
  ]
}'
Response
{
  "items": [
    {
      "app": {
        "appId": 0,
        "name": "string"
      },
      "classId": 0,
      "gems": 0,
      "isFoil": true,
      "isMarketable": true,
      "kind": "card",
      "lastSoldAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "points": 0,
      "priceCents": 0,
      "rarity": 0
    }
  ],
  "missing": {
    "appIds": [
      0
    ],
    "classIds": [
      0
    ]
  }
}