# Steamdb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover Steam games with real-time data on trending titles, most played games, top-rated releases, current sales, and free promotions. Get detailed information about any game including ratings, player counts, and pricing to find your next favorite game or track what's popular on Steam.

**Category:** Entertainment | **Website:** [steamdb.info/](https://steamdb.info/) | **Docs:** [parse.bot/marketplace/00bafd6e-003b-46d1-9d4b-c6cca5cf1a6b/steamdb-info-api](https://parse.bot/marketplace/00bafd6e-003b-46d1-9d4b-c6cca5cf1a6b/steamdb-info-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_app_info

Retrieve comprehensive information about a Steam app from SteamDB including metadata (name, type, developer, publisher, supported systems, release date), current and peak player counts, user review summary with score label, game tags and genres, content descriptors, supported languages with audio/subtitle details, all depots with their IDs, names, platform info, and sizes, all branches with their build IDs and timestamps, achievements with unlock percentages, full build history with dates, times, titles, depot manifest IDs per build, and whether each build has patch notes, and the actual patch note content for up to 5 most recent builds that have official patch notes. Each build in the history requires an additional request for depot manifests, so cost scales with the number of builds. If the site rate-limits during fetching, remaining builds will have empty depot arrays. Each build with patch notes also requires parsing, so cost scales with annotated builds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `appid` | string | Yes | Steam application ID (e.g. '730' for Counter-Strike 2, '570' for Dota 2) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_app_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appid":"<string>"}'
```

### get_build_details

Retrieve detailed manifest information for a specific Steam build by its build ID. Returns the build's date, time, title, and a list of all depots with their current manifest IDs. Build IDs can be obtained from the get_game_builds endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `build_id` | string | Yes | Steam build ID (e.g. '24537688' from get_game_builds results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_build_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"build_id":"<string>"}'
```

### get_current_sales

Retrieve current Steam sales with discount percentages, prices, and ratings. Returns all currently discounted games from the SteamDB sales page, sorted by relevance.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_current_sales \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_free_promotions

Retrieve currently active and upcoming free game promotions on Steam. Active promotions include full details (image, store link, time range). Upcoming promotions include estimated dates only. Returns a flat list mixing both statuses.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_free_promotions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_game_builds

Retrieve the build history for a specific Steam game from SteamDB. Returns recent builds with build ID, publication date/time, patch title, and manifest IDs for each depot. Each build requires an additional request to fetch depot manifests, so the endpoint cost scales with the limit parameter. Default limit is 5 builds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `appid` | string | Yes | Steam application ID (e.g. '730' for Counter-Strike 2, '570' for Dota 2) |
| `limit` | integer | No | Maximum number of builds to return. Each build requires a separate request for depot manifest data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_game_builds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appid":"<string>","limit":"<integer>"}'
```

### get_game_details

Retrieve full details for a specific game including price history across all Steam currencies and owner estimations from third-party providers. The price history shows current price and lowest recorded price per currency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `appid` | string | Yes | Steam application ID (e.g. '730' for Counter-Strike 2, '570' for Dota 2) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appid":"<string>"}'
```

### get_most_played_games

Retrieve the most played games currently on Steam with player counts and peak data. Games are ranked by current player count. Data is live and updates frequently.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_most_played_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_top_rated_games

Retrieve the highest-rated games on Steam ranked by user review percentage. Returns games sorted by positive review ratio with review counts and peak player data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_top_rated_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trending_games

Retrieve trending games from the SteamDB homepage with their follower counts. Shows games currently gaining the most community interest.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/get_trending_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_games

Search for games and apps on SteamDB by keyword. Returns matching results with app IDs and app types. Results are limited to the first page (up to 100 results).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'portal', 'counter-strike') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-steamdb-info-api-00bafd6e/search_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```