---
title: Finding ids
description: Get app ids, accounts, class ids and group ids. Ids are free. Data costs units.
sidebar:
  icon: search
  order: 3
---

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`](/data-files) has the same apps as one file, without an API key.

```bash
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](https://github.com/nolddor/steam-badges-db). They use the same format. To switch, change the URL. See [Data files](/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](/your-account) 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`.
