# Steam API
> The Steam store as an API. Search Steam for games and get each game's full details — short description, genres and categories, developers and publishers, release date, platforms (Windows/macOS/Linux), Metacritic score, price and discount, header image and screenshots — and its player-review summary, from the famous "Overwhelmingly Positive" / "Mixed" rating down to the exact positive percentage and total review count, plus a few recent reviews. Look up any game by its Steam app id (e.g. 620 for Portal 2, 1245620 for Elden Ring). Prices are country-specific. Ideal for game directories, review and rating dashboards, Discord bots, wishlists and gaming apps. Public Steam store data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/steam-api/..."
```

## Pricing
- **Free** (Free) — 3,800 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 50,600 calls/Mo, 8 req/s
- **Pro** ($13/Mo) — 246,600 calls/Mo, 20 req/s
- **Mega** ($35/Mo) — 1,210,500 calls/Mo, 50 req/s

## Endpoints

### Steam

#### `GET /v1/app` — Full game details

**Parameters:**
- `appid` (query, required, string) — Steam app id, e.g. 620 (Portal 2) Example: `620`
- `country` (query, optional, string) — 2-letter country for prices, default us

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steam-api/v1/app?appid=620"
```

**Response:**
```json
{
    "data": {
        "app": {
            "name": "Portal 2",
            "type": "game",
            "appid": 620,
            "price": 9.99,
            "genres": [
                "Action",
                "Adventure"
            ],
            "is_free": false,
            "website": "http://www.thinkwithportals.com/",
            "currency": "USD",
            "platforms": {
                "mac": false,
                "linux": true,
                "windows": true
            },
            "store_url": "https://store.steampowered.com/app/620",
            "categories": [
                "Single-player",
                "Multi-player",
                "Co-op",
                "Online Co-op",
                "Shared/Split Screen Co-op",
                "Shared/Split Screen",
                "Steam Achievements",
                "Full controller support",
                "Steam Trading Cards",
                "Captions available",
                "Steam Workshop",
                "Steam Workshop",
                "Camera Comfort",
                "Custom Volume Controls",
                "Playable without Timed Input",
                "Save Anytime",
                "Stereo Sound",
                "Surround Sound",
                "Steam Cloud",
                "Stats",
                "Includes level editor",
                "Commentary available",
                "Remote Play on Phone",
                "Remote Play on Tablet",
                "Remote Play on TV",
  
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/reviews` — Review summary + recent reviews

**Parameters:**
- `appid` (query, required, string) — Steam app id, e.g. 620 Example: `620`
- `limit` (query, optional, string) — Recent reviews to include (0-20, default 5) Example: `5`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steam-api/v1/reviews?appid=620&limit=5"
```

**Response:**
```json
{
    "data": {
        "appid": 620,
        "count": 5,
        "reviews": [
            {
                "review": "[h1] PERFECTION EXPANDED [/h1]\n\n[b][i]  Taking everything that made the original revolutionary and expanding it into a grand, cinematic masterpiece. Portal 2 elevates the puzzle design with brilliant new mechanics like propulsion and repulsion gels, while diving deep into the fascinating, decayed lore of Aperture Science.\n\nThe addition of Wheatley and Cave Johnson brings some of the funniest, sharpest dialogue ever written for a video game. Combined with an equally stellar co-op campaign that stands as one of the best cooperative experiences of all time, this entry is pure, unadulterated gamin",
                "created": "2026-05-24T20:25:49.000Z",
                "votes_up": 10,
                "recommended": true,
                "playtime_hours": 26
            },
            {
                "review": "Прошел Portal 2 и остался очень доволен, НО теперь я хочу Portal 3!!! XD\r\nИгра просто офигенная. По сравнению с первой частью здесь стало заметно больше головоломок, и если в первой части многое было более-менее интуитивно понятно, то во второй уже приходится реально сидеть и думать, что, куда и как использовать. Н
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search Steam games

**Parameters:**
- `term` (query, required, string) — Search term, e.g. portal Example: `portal`
- `country` (query, optional, string) — 2-letter country for prices, default us

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steam-api/v1/search?term=portal"
```

**Response:**
```json
{
    "data": {
        "term": "portal",
        "count": 10,
        "country": "us",
        "results": [
            {
                "name": "Portal 2",
                "type": "app",
                "appid": 620,
                "image": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/620/capsule_231x87.jpg?t=1745363004",
                "price": 9.99,
                "currency": "USD",
                "store_url": "https://store.steampowered.com/app/620"
            },
            {
                "name": "Portal",
                "type": "app",
                "appid": 400,
                "image": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/400/capsule_231x87.jpg?t=1745368554",
                "price": 9.99,
                "currency": "USD",
                "store_url": "https://store.steampowered.com/app/400"
            },
            {
                "name": "BRAZILIAN DRUG DEALER 3: I OPENED A PORTAL TO HELL IN THE FAVELA TRYING TO REVIVE MIT AIA I NEED TO CLOSE IT",
                "type": "app",
                "appid": 3191050,
                "image": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/3191050/4dd75bb2a4abd1df8af59468242d8a531ae3992d/capsule_231x87_alt_assets_2.jpg?t=1779888922",
                "price": 3.39,
                "currency": "USD",
                "store_url": "https://store.steampowered.com/app/3191050"
            },
            {
                "name": "Portal Kn
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/steam-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Live Steam store data. /v1/search?term= searches games (appid, name, price); /v1/app?appid= returns a game's full details (description, genres, developers, Metacritic, platforms, screenshots, price); /v1/reviews?appid= returns the review summary (e.g. 'Overwhelmingly Positive', positive %) plus a few recent reviews. Prices are country-specific (default us).",
        "source": "Steam store (public endpoints)",
        "endpoints": [
            "/v1/search",
            "/v1/app",
            "/v1/reviews",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T11:45:22.666Z",
        "request_id": "e6f74e59-672e-460a-8eec-968a9be0dd04"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/steam-api
OpenAPI spec: https://www.oanor.com/api/steam-api/openapi.json
