Steam
Stats
Get a Steam user's in-game stats and achievements for a specific game.
Endpoint
This endpoint returns the in-game stats and unlocked achievements for a specific game on a Steam user's account. The available stat names are defined by each game's stats schema and vary per title.
GET /v2/steam/users/{steamid}/stats/{appid}
Required parameters
steamid
string
The Steam ID of the user whose stats you want to fetch. Accepts various Steam ID formats.
appid
number
The Steam application ID of the game whose stats you want to fetch.
Authentication
Include your API key as the x-api-key request header.
x-api-key: YourSecretAPIKey
Response fields
| Field | Type | Description |
|---|---|---|
steamID | string | The user's SteamID64. |
game | string | The name of the game. |
achievements | array | List of achievements the user has unlocked in this game. Only unlocked achievements are included. See fields below. |
stats | array | List of in-game stat entries tracked by the game. See fields below. |
Achievement object
| Field | Type | Description |
|---|---|---|
name | string | The internal identifier of the achievement. |
unlocked | boolean | Always true in this response — only unlocked achievements are returned here. |
Stat object
| Field | Type | Description |
|---|---|---|
name | string | The internal identifier of the stat. Stat names are defined by the game. |
value | number | The stat's current value. May be an integer or a floating-point number depending on the stat. |
Response example
Example output for this endpoint. For brevity's sake, most achievements and stats were omitted.
response.json
{
"success": true,
"result": {
"steamID": "76561198038526790",
"game": "Rust",
"achievements": [
{ "name": "COLLECT_100_WOOD", "unlocked": true },
{ "name": "COLLECT_200_STONE", "unlocked": true },
{ "name": "CONSTRUCT_BASE", "unlocked": true }
],
"stats": [
{ "name": "deaths", "value": 121 },
{ "name": "bullet_fired", "value": 6473 },
{ "name": "kill_player", "value": 67 },
{ "name": "harvest.wood", "value": 90397 },
{ "name": "comfort_duration", "value": 11709.4150390625 }
]
}
}