---
title: "🎮 Get the Player History of One Steam Game"
method: GET
path: "/steam/api/apps/{appid}/players"
tags: ["Apps"]
---

# 🎮 Get the Player History of One Steam Game

`GET /steam/api/apps/{appid}/players`

## Request

- Base URL: `https://www.steamwebapi.com`
- URL: `https://www.steamwebapi.com/steam/api/apps/{appid}/players`
- Auth: API key in query parameter `key`

Baseurl: https://www.steamwebapi.com/steam/api/apps/730/players?key=YOUR_API_KEY

    💬 **What this endpoint does:**
    - Returns the player history of one Steam game: players right now, 24-hour, 7-day, 30-day and all-time peaks, 30-day average and low, gain against the last month, hours played, rank and trend.
    - Adds a chart series for the requested range and the monthly table with average players, gain, % gain and peak players back to the game's release (as far as July 2012).
    - Includes the daily rank history.

    🛠️ **Features:**
    - `range=24h`, `7d` and `30d` return hourly values, `90d` and `1y` daily values (average, peak with time, low), `all` monthly values.
    - Every value is the mean of the measurements in its hour; peaks and averages derive from those hourly values. `samples` and `hours` show how many measurements stand behind a value.
    - Busy games are measured every 5 minutes, games with at least 10 players at least hourly, quieter games less often; `samplinginterval` gives the current interval in seconds.

    🌐 **How to use:**
    - Draw a game chart from `series` and a history table from `months`.
    - Use the catalog endpoint with `sort=players`, `peak30d`, `change24h` or `peakalltime` for top lists.

## Path parameters

- `appid` string, required

## Query parameters

- `range` '24h' | '7d' | '30d' | '90d' | '1y' | 'all'
- `no_cache` '0' | '1'
- `format` string
- `pretty` '0' | '1'

## Response `200`

Request was successful and the player history is returned.

## Other responses

- `400`: A query parameter could not be used as given.
- `404`: The requested appid is not a game in the catalog.
- `429`: Rate limit exceeded. Too many requests in a short time frame.

---

[API](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation.md) · [All operations](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/steamwebapi/apis/steamwebapi-com-third-party-steam-market-api-documentation/revisions/f9a4109cbda6?raw)