# Steam on Onekey

> 14 endpoints for Steam (12 stable, 2 beta), 1 to 5 credits each. Category: Gaming. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/steam
Reference (Markdown): https://onekey.dev/docs/api/steam.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 14 mapped Steam endpoints return each:

- `entity.id` (string): 8
- `entity.name` (string): 7
- `listing.currency` (string): 6
- `media.thumbnailUrl` (URL): 6
- `listing.discountPercent` (number): 5
- `listing.originalPrice` (number): 5
- `author.displayName` (string): 2
- `author.id` (string): 2
- `content.createdAt` (ISO 8601 date): 2
- `content.id` (string): 2
- `content.text` (string): 2
- `author.avatarUrl` (URL): 1
- `author.url` (URL): 1
- `content.title` (string): 1
- `content.url` (URL): 1
- `engagement.likes` (integer): 1
- `entity.stats.rank` (integer): 1
- `entity.type` (string): 1
- plus 13 platform-specific fields under `ext.`

## Endpoints

### steam.coming_soon

Steam coming soon.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/coming_soon` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `listing.discountPercent`, `listing.originalPrice`, `listing.currency`, `media.thumbnailUrl`, `ext.finalPrice`
- Reference: https://onekey.dev/docs/api/steam/coming_soon.md

### steam.current_players

Current number of players of a Steam app.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/steam/current_players?appid=570` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `appid` (string, required): Steam app id, e.g. 570
- Fields returned: `ext.players`
- Reference: https://onekey.dev/docs/api/steam/current_players.md

### steam.featured

Steam store featured games.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/featured` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `listing.discountPercent`, `listing.originalPrice`, `listing.currency`, `media.thumbnailUrl`, `ext.finalPrice`
- Reference: https://onekey.dev/docs/api/steam/featured.md

### steam.most_played

Steam most-played games ranking (by peak concurrent players).
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/most_played` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.stats.rank`, `ext.peakPlayers`, `ext.lastWeekRank`
- Reference: https://onekey.dev/docs/api/steam/most_played.md

### steam.new_releases

Steam new releases.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/new_releases` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `listing.discountPercent`, `listing.originalPrice`, `listing.currency`, `media.thumbnailUrl`, `ext.finalPrice`
- Reference: https://onekey.dev/docs/api/steam/new_releases.md

### steam.news

Latest news posts for a Steam app.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/news?appid=570` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `appid` (string, required): Steam app id, e.g. 570
- Fields returned: `content.id`, `content.title`, `content.url`, `author.displayName`, `content.text`, `content.createdAt`, `ext.source`
- Reference: https://onekey.dev/docs/api/steam/news.md

### steam.owned_games

Games owned by a Steam user (public profiles).
- Price: 5 credits per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/owned_games?steamid=76561197960435530` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `steamid` (string, required): SteamID64
- Fields returned: `entity.id`, `entity.name`, `ext.playtimeMinutes`
- Reference: https://onekey.dev/docs/api/steam/owned_games.md

### steam.player_count

Current player count of a Steam app.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/steam/player_count?appid=620` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `appid` (string, required): Steam app id
- Fields returned: `ext.players`, `ext.result`
- Reference: https://onekey.dev/docs/api/steam/player_count.md

### steam.player_summary

Steam player profile summary by SteamID64.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/steam/player_summary?steamid=76561197960435530` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `steamid` (string, required): SteamID64
- Fields returned: `author.id`, `author.displayName`, `author.url`, `author.avatarUrl`
- Reference: https://onekey.dev/docs/api/steam/player_summary.md

### steam.reviews

Recent public reviews of a Steam app plus its review-score summary.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/reviews?appid=620` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `appid` (string, required): Steam app id, e.g. 570
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `author.id`, `engagement.likes`, `ext.votedUp`, `ext.playtimeMinutes`
- Reference: https://onekey.dev/docs/api/steam/reviews.md

### steam.reviews_summary

Steam review score summary for an app.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/steam/reviews_summary?appid=570` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `appid` (string, required): Steam app id, e.g. 570
- Fields returned: `ext.reviewScoreDesc`, `ext.totalReviews`, `ext.positive`, `ext.negative`
- Reference: https://onekey.dev/docs/api/steam/reviews_summary.md

### steam.search

Search the Steam store.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/search?q=portal` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Game name
- Fields returned: `entity.id`, `entity.name`, `entity.type`, `listing.currency`, `media.thumbnailUrl`, `ext.finalPrice`, `ext.metascore`
- Reference: https://onekey.dev/docs/api/steam/search.md

### steam.specials

Steam specials (discounted games).
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/specials` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `listing.discountPercent`, `listing.originalPrice`, `listing.currency`, `media.thumbnailUrl`, `ext.finalPrice`
- Reference: https://onekey.dev/docs/api/steam/specials.md

### steam.top_sellers

Steam top sellers.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/steam/top_sellers` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `listing.discountPercent`, `listing.originalPrice`, `listing.currency`, `media.thumbnailUrl`, `ext.finalPrice`
- Reference: https://onekey.dev/docs/api/steam/top_sellers.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/steam/current_players?appid=570" \
  -H "x-api-key: YOUR_API_KEY"
```