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

List every app with trading cards

Returns the id, name and card count of every app with a trading card badge, by app id.

Paging

A page holds 5,000 apps by default and up to 20,000. Send nextCursor back as cursor for the next page. It is null on the last page.

Freshness

The list is up to an hour behind steamsets.com.

Cost

This route is free. It uses no units of the key’s daily allowance.

Example

{
  "apps": [
    { "appId": 220, "name": "Half-Life 2", "cardCount": 8, "hasNormal": true, "hasFoil": true }
  ],
  "nextCursor": "220"
}
POST/v1/app.list
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
cursorstring

The nextCursor of the previous page. Leave it out for the first page.

limitinteger<int64>

Apps per page.

min 1 · max 20000 · default: 5000
Responses
200

OK

appsAppListApp[]required

Apps with trading cards, by app id.

Show properties
Array of AppListApp
appIdinteger<int32>required
min 0
cardCountinteger<int32>required

Trading cards in one set. A foil set has as many as a normal one.

min 0
hasFoilbooleanrequired

The app has a foil badge.

hasNormalbooleanrequired

The app has a normal badge.

namestringrequired
nextCursorstring | nullrequired

Send it as cursor for the next page. Null on the last page.

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"
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"
503

Service Unavailable

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/app.list' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "cursor": "730",
  "limit": 5000
}'
Response
{
  "apps": [
    {
      "appId": 0,
      "cardCount": 0,
      "hasFoil": true,
      "hasNormal": true,
      "name": "string"
    }
  ],
  "nextCursor": "string"
}