# Steam — 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 Steam Store listings, fetch featured categories (specials, top sellers, new releases), and retrieve app details and user reviews by Steam AppID.

**Category:** Entertainment | **Website:** [store.steampowered.com/](https://store.steampowered.com/) | **Docs:** [parse.bot/marketplace/6641d22a-4734-4375-ad18-1d547c3d1d33/store-steampowered-com-api](https://parse.bot/marketplace/6641d22a-4734-4375-ad18-1d547c3d1d33/store-steampowered-com-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-store-steampowered-com-api-6641d22a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_app_details

Get detailed information about a Steam product including description, pricing, system requirements (parsed into structured fields for OS, Processor, Memory, Graphics), categories, genres, screenshots, and more. Returns null price_overview for free games.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `appid` | string | Yes | Steam application ID (e.g. 1245620 for Elden Ring, 570 for Dota 2, 730 for CS2) |
| `country` | string | No | Country code for pricing (e.g. US, GB, DE) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-steampowered-com-api-6641d22a/get_app_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appid":"<string>","country":"<string>"}'
```

### get_app_reviews

Get user reviews for a Steam product with filtering and cursor-based pagination. Returns reviews with author info (playtime, games owned), vote data, and a cursor for fetching subsequent pages. First page uses cursor '*'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `appid` | string | Yes | Steam application ID |
| `cursor` | string | No | Pagination cursor ('*' for first page, then use returned cursor for next pages) |
| `day_range` | integer | No | Filter reviews to within N days |
| `filter` | string | No | Sort filter for reviews |
| `language` | string | No | Review language filter |
| `num_per_page` | integer | No | Number of reviews per page (max 100) |
| `purchase_type` | string | No | Filter by purchase source |
| `review_type` | string | No | Filter by review sentiment |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-steampowered-com-api-6641d22a/get_app_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appid":"<string>","cursor":"<string>","day_range":"<integer>","filter":"<string>","language":"<string>","num_per_page":"<integer>","purchase_type":"<string>","review_type":"<string>"}'
```

### get_featured

Get featured, special, trending, and top-selling products from the Steam store. Returns products grouped by category (specials, top_sellers, new_releases, coming_soon) with pricing and discount information. When category is specified, only that section is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter to return only one section |
| `country` | string | No | Country code for pricing (e.g. US, GB, DE) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-steampowered-com-api-6641d22a/get_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","country":"<string>"}'
```

### search_products

Search and list Steam products with filters for category, tags, price, platform, and more. Returns paginated results with pricing, review scores, and platform availability. Offset-based: caller controls start/count for manual paging.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Product type filter |
| `count` | integer | No | Number of results per page (max 100) |
| `language` | string | No | Supported language filter |
| `max_price` | string | No | Max price filter ('free' or numeric value in dollars) |
| `os` | string | No | OS platform filter |
| `sort_by` | string | No | Sort order for results |
| `specials` | boolean | No | Only show discounted products |
| `start` | integer | No | Pagination offset (number of results to skip) |
| `tags` | string | No | Tag IDs for genre filtering (comma-separated, e.g. '3959' for roguelike) |
| `term` | string | No | Search keyword |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-store-steampowered-com-api-6641d22a/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","count":"<integer>","language":"<string>","max_price":"<string>","os":"<string>","sort_by":"<string>","specials":"<boolean>","start":"<integer>","tags":"<string>","term":"<string>"}'
```
