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

Get the trading card badges of apps

Returns the trading card badges of up to 100 apps, sale and event apps included.

What you get

  • Every badge level with its id, image, XP, scarcity, tracked holders, the highest level crafted, and the first and latest craft SteamSets knows.
  • For card badges, the cards and the card, set, badge and booster prices in US cents.
  • A badge without prices, such as a sale or event tier, has no prices, booster, isMarketable, isEveryCardListed or updatedAt.

Ids that SteamSets does not know, or that have no badge, are in missing.

Freshness

Prices are up to an hour behind steamsets.com, and badge data up to 30 minutes.

Cost

Each app id uses one unit of the key’s 5,000 daily units, found or not.

Example

{
  "apps": [
    {
      "appId": 730,
      "name": "Counter-Strike 2",
      "isSale": false,
      "isEvent": false,
      "normal": {
        "cardCount": 5,
        "isMarketable": true,
        "prices": { "setCents": 52, "toLevelCents": [52, 104, 157, 210] },
        "levels": [{ "badgeId": "bdg_4f2k", "steamBadgeId": 2, "level": 1, "xp": 100, "scarcity": 812345 }]
      }
    }
  ],
  "missing": [],
  "snapshotAt": "2026-11-16T10:00:00Z"
}
POST/v1/app.get
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
appIdsinteger<int32>[]required

Steam app ids, as in store.steampowered.com/app/<appId>. Each id uses one unit of the key's daily allowance, found or not.

min items 1 · max items 100
Responses
200

OK

appsAppGetApp[]required

The requested apps that have a badge, in request order.

Show properties
Array of AppGetApp
appIdinteger<int32>required

Steam app id.

min 0
foilAppGetBadge

Missing when the app has no foil badge.

Show properties
boosterAppGetBooster

Booster pack prices in US cents. Missing when the app has no booster pack or no prices.

Show properties
buyOrderCentsinteger<int32>required

Highest booster pack buy order.

min 0
gemsinteger<int32>required

Gems to craft one booster pack.

min 0
priceCentsinteger<int32>required

Cheapest booster pack listing.

min 0
cardCountinteger<int32>required
min 0
cardsAppGetCard[]required

Empty without prices.

Show properties
Array of AppGetCard
buyOrderCentsinteger<int32>required

Highest buy order.

min 0
copyPricesCentsinteger<int32>[]required

copyPricesCents[k-1] is the total price of k copies from the cheapest listings. Empty when not read yet.

namestringrequired
priceCentsinteger<int32>required

Cheapest listing.

min 0
isEveryCardListedboolean

Every card of this badge has a listing on the Steam market. Missing without prices.

isMarketableboolean

False when a card of this badge cannot be sold on the Steam market. Missing without prices.

levelsAppGetLevel[]required
Show properties
Array of AppGetLevel
badgeIdstringrequired

The SteamSets id of this badge level.

firstCompletedAtstring<date-time>

The first craft of this level that SteamSets knows. Missing when it knows none.

highestLevelinteger<int32>required

The highest level anyone SteamSets knows has crafted of this badge.

min 0
imagestringrequired

The badge image of this level.

lastCompletedAtstring<date-time>

The latest craft of this level that SteamSets knows. Missing when it knows none.

levelinteger<int32>required
min 0
namestringrequired
scarcityinteger<int32>required

Holders of this level, as Steam counts them.

min 0
steamBadgeIdinteger<int32>required

Steam's id of the badge, 0 for a sale or event tier.

min 0
trackedHoldersinteger<int32>required

Holders of this level that SteamSets has indexed.

min 0
xpinteger<int32>required
min 0
pricesAppGetPrices

Prices in US cents. Missing without prices.

Show properties
cardAverageCentsinteger<int32>required
min 0
cardBuyOrderAverageCentsinteger<int32>required
min 0
fullBadgeCentsinteger<int32>required

Every level of the badge from the cheapest listings, 0 when some card cannot be bought that many times.

min 0
setBuyOrderCentsinteger<int32>required

One of each card at the highest buy orders.

min 0
setCentsinteger<int32>required

One of each card from the cheapest listings.

min 0
toLevelCentsinteger<int32>[]required

toLevelCents[n-1] is the price of the first n levels, for n from 1 to 4. A foil badge has one level, so all four are the same.

updatedAtstring<date-time>

When SteamSets last read these prices from the Steam market. Missing without prices.

imagestringrequired

The app's capsule image.

isEventbooleanrequired

A Steam event's badge rather than a game's.

isSalebooleanrequired

A Steam sale's badge rather than a game's.

namestringrequired
normalAppGetBadge

Missing when the app has no normal badge. A sale or event app's tiers are here.

Show properties
boosterAppGetBooster

Booster pack prices in US cents. Missing when the app has no booster pack or no prices.

cardCountinteger<int32>required
min 0
cardsAppGetCard[]required

Empty without prices.

isEveryCardListedboolean

Every card of this badge has a listing on the Steam market. Missing without prices.

isMarketableboolean

False when a card of this badge cannot be sold on the Steam market. Missing without prices.

levelsAppGetLevel[]required
pricesAppGetPrices

Prices in US cents. Missing without prices.

updatedAtstring<date-time>

When SteamSets last read these prices from the Steam market. Missing without prices.

missinginteger<int32>[]required

The requested apps that SteamSets does not know or that have no badge.

snapshotAtstring<date-time>required

When the prices were copied for the API. They are up to an hour behind steamsets.com.

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"
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.get' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "appIds": [
    730,
    753
  ]
}'
Response
{
  "apps": [
    {
      "appId": 0,
      "foil": {
        "booster": {
          "buyOrderCents": 0,
          "gems": 0,
          "priceCents": 0
        },
        "cardCount": 0,
        "cards": [
          {
            "buyOrderCents": 0,
            "copyPricesCents": [
              0
            ],
            "name": "string",
            "priceCents": 0
          }
        ],
        "isEveryCardListed": true,
        "isMarketable": true,
        "levels": [
          {
            "badgeId": "bdg_123",
            "firstCompletedAt": "2019-08-24T14:15:22Z",
            "highestLevel": 0,
            "image": "string",
            "lastCompletedAt": "2019-08-24T14:15:22Z",
            "level": 0,
            "name": "string",
            "scarcity": 0,
            "steamBadgeId": 0,
            "trackedHolders": 0,
            "xp": 0
          }
        ],
        "prices": {
          "cardAverageCents": 0,
          "cardBuyOrderAverageCents": 0,
          "fullBadgeCents": 0,
          "setBuyOrderCents": 0,
          "setCents": 0,
          "toLevelCents": [
            0
          ]
        },
        "updatedAt": "2019-08-24T14:15:22Z"
      },
      "image": "string",
      "isEvent": true,
      "isSale": true,
      "name": "string",
      "normal": {
        "booster": {
          "buyOrderCents": 0,
          "gems": 0,
          "priceCents": 0
        },
        "cardCount": 0,
        "cards": [
          {
            "buyOrderCents": 0,
            "copyPricesCents": [
              0
            ],
            "name": "string",
            "priceCents": 0
          }
        ],
        "isEveryCardListed": true,
        "isMarketable": true,
        "levels": [
          {
            "badgeId": "bdg_123",
            "firstCompletedAt": "2019-08-24T14:15:22Z",
            "highestLevel": 0,
            "image": "string",
            "lastCompletedAt": "2019-08-24T14:15:22Z",
            "level": 0,
            "name": "string",
            "scarcity": 0,
            "steamBadgeId": 0,
            "trackedHolders": 0,
            "xp": 0
          }
        ],
        "prices": {
          "cardAverageCents": 0,
          "cardBuyOrderAverageCents": 0,
          "fullBadgeCents": 0,
          "setBuyOrderCents": 0,
          "setCents": 0,
          "toLevelCents": [
            0
          ]
        },
        "updatedAt": "2019-08-24T14:15:22Z"
      }
    }
  ],
  "missing": [
    0
  ],
  "snapshotAt": "2019-08-24T14:15:22Z"
}