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

Finding ids

Get app ids, accounts, class ids and group ids. Ids are free. Data costs units.

The API looks things up by id. It has no search and no catalogue browse. Getting ids is free, and you spend units only when you ask for data.

App ids

An app id is the number in store.steampowered.com/app/<appId>.

  • app.list returns the id, name and card count of every app with trading cards. It is free. It returns 5,000 apps per page by default and up to 20,000 with limit. Send nextCursor as cursor to get the next page. nextCursor is null on the last page.
  • badges.json has the same apps as one file, without an API key.
curl https://api.steamsets.com/v1/app.list \
  -H "Authorization: Bearer $STEAMSETS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 20000}'

badges.json

GET /v1/badges.json and GET /v1/badges.slim.json are a drop-in for nolddor/steam-badges-db. They use the same format. To switch, change the URL. See Data files.

Accounts

account.get takes an accounts array of strings. Each string can be:

You have Example
An account id "882338006"
A SteamID64 "76561198842603734"
A vanity "steamsets"
A Steam profile URL "https://steamcommunity.com/id/gabelogannewell"
A profile URL by number "https://steamcommunity.com/profiles/76561198842603734"

A bare vanity matches a SteamSets vanity first, then a Steam vanity. Each answer has an input field with the string you sent, so you can match results to your list.

account.get returns only accounts that SteamSets already tracks. An account it does not know is in missing. So is an account that is hidden on SteamSets. You cannot tell the two apart.

Your own account needs no id. The account.me routes act on the account that owns the API key, and they are free.

Class ids

A class id is the classid of an item in a Steam inventory. Send up to 100 of them to item.get as classIds. To get every item of an app instead (cards, foils, booster packs, backgrounds and emoticons), send up to 10 appIds. Send one or the other, not both.

A card that has never been on the Steam market has classId 0.

Group ids

A group id is the low 32 bits of the group’s SteamID64. Send up to 100 of them to group.get as groupIds.