---
title: Data files
description: Download every app with trading cards as one JSON file. No API key needed.
sidebar:
  icon: file-json
  order: 5
---

Two files list every app with trading cards. They need no API key and use no units.

| File                                                                    | Contents                                     |
| ----------------------------------------------------------------------- | -------------------------------------------- |
| [`/v1/badges.json`](https://api.steamsets.com/v1/badges.json)           | Each app id, with its name and cards per set |
| [`/v1/badges.slim.json`](https://api.steamsets.com/v1/badges.slim.json) | Each app id, with its cards per set          |

## Replace steam-badges-db

The files use the format of [nolddor/steam-badges-db](https://github.com/nolddor/steam-badges-db). If your bot reads that project's files, change the URL and nothing else.

## Format

Both files are a JSON object keyed by app id. In `badges.json`, `size` is the number of cards in one set:

```json
{
  "220": { "name": "Half-Life 2", "size": 8 }
}
```

`badges.slim.json` has the size only:

```json
{
  "220": 8
}
```

The files have no prices. Get prices with [`app.get`](/reference/apps/app-get).

## Refresh and caching

We rebuild the files every hour. They are sent with `Cache-Control: public, max-age=3600`. Download them at most once an hour.

```bash
curl -O https://api.steamsets.com/v1/badges.json
```
