SteamCharts Player-Count Scraper

Track real-time Steam concurrent-player counts, sourced from steamcharts.com — the go-to independent tracker of "who's playing what" on Steam. Pull the full top-games leaderboard, the day's biggest 24-hour trending gainers, all-time peak-player records, a text search across every tracked title, or the complete player-count history for any specific game back to when SteamCharts began tracking it in mid-2012.

No login, no API key, no cookies required.

What this actor does

• topGames (default) — the full ranked leaderboard of every game SteamCharts tracks, sorted by current concurrent players, paginated automatically until your maxItems cap is reached.
• trending — the day's top 24-hour concurrent-player gainers (biggest percentage jumps). SteamCharts surfaces a short, fixed-size list here (typically under 10 games) — maxItems is a ceiling, not a guarantee.
• search — text search across every tracked game by name/title.
• gameDetails — full detail + player-count history for one or more explicit Steam App IDs: current players, 24-hour peak, all-time peak, a month-by-month summary table, and the complete historical average-player chart data (monthly resolution for older periods, refining to daily/hourly for the most recent months).
• topRecords — the all-time leaderboard of highest concurrent-player peaks ever recorded on Steam, with the date each record was set. SteamCharts surfaces a short, fixed-size list here (typically around 10-20 games) — maxItems is a ceiling, not a guarantee.

Output per record

topGames mode

Field	Description
rank	Current leaderboard position
appId	Steam App ID
name	Game title
currentPlayers	Current concurrent players
peakPlayers30d	Peak concurrent players in the last 30 days
hoursPlayed30d	Total hours played across all players in the last 30 days
imageUrl	Game header image
sourceUrl	SteamCharts page for this game

trending mode

Field	Description
appId	Steam App ID
name	Game title
gainPercent24h	Percent change in concurrent players over the last 24 hours
currentPlayers	Current concurrent players
imageUrl	Game header image
sourceUrl	SteamCharts page for this game

search mode

Field	Description
appId	Steam App ID
name	Game title
currentPlayers	Current concurrent players
avgPlayers30d	Average concurrent players over the last 30 days
gain30d	Absolute change in average players over 30 days
gainPercent30d	Percent change in average players over 30 days
imageUrl	Game header image
sourceUrl	SteamCharts page for this game

gameDetails mode

Field	Description
appId	Steam App ID
name	Game title
currentPlayers	Current concurrent players
currentPlayersAsOf	UTC timestamp SteamCharts last refreshed the current-player count
peak24h	Peak concurrent players in the last 24 hours
peakAllTime	Highest concurrent-player count ever recorded for this game
storeUrl	Steam store page
communityHubUrl	Steam Community hub page
imageUrl	Game header image
sourceUrl	SteamCharts page for this game
monthlyHistory[]	Month-by-month summary: month, avgPlayers, gain, gainPercent, peakPlayers
historicalChartData[]	Complete average-player timeseries: month (YYYY-MM-DD), timestamp (full UTC instant, YYYY-MM-DDTHH:MM:SSZ), avgPlayers — going back to when SteamCharts began tracking the game (mid-2012 for the oldest titles). Resolution isn't uniformly monthly: older periods have one point per calendar month, while the most recent 1-3 months progressively refine to daily or even hourly data points as SteamCharts accumulates fresh samples, so you may see several entries sharing the same month date with different timestamp/avgPlayers values — that's expected, not duplicate/bad data. Use timestamp (not month) to tell same-day points apart or sort them chronologically

topRecords mode

Field	Description
appId	Steam App ID
name	Game title
allTimePeakPlayers	Highest concurrent-player count ever recorded
allTimePeakDate	Date/time the record was set (ISO 8601, UTC)
imageUrl	Game header image
sourceUrl	SteamCharts page for this game

Every record also includes recordType and scrapedAt (UTC timestamp). Fields that can't be populated for a given record are simply omitted — you'll never see null, empty strings, or placeholder values.

Input

Field	Type	Default	Description
mode	select	topGames	topGames / trending / search / gameDetails / topRecords
searchQuery	string	counter-strike	Game name to search for (mode=search)
appIds	array	["730"]	Steam App IDs to fetch (mode=gameDetails)
includeFullHistory	boolean	true	Include the complete historicalChartData[] (mode=gameDetails); disable for a lighter response
minCurrentPlayers	integer	–	Drop games below this concurrent-player count (modes topGames/trending/search)
maxCurrentPlayers	integer	–	Drop games above this concurrent-player count (modes topGames/trending/search)
maxItems	integer	20	Hard cap on records emitted (1–1000)

Example: top 50 most-played games right now

{
  "mode": "topGames",
  "maxItems": 50
}

Example: today's biggest trending gainers

{
  "mode": "trending"
}

Example: search for battle royale titles

{
  "mode": "search",
  "searchQuery": "battlegrounds"
}

Example: full history for Counter-Strike 2 and Dota 2

{
  "mode": "gameDetails",
  "appIds": ["730", "570"],
  "includeFullHistory": true
}

Example: mid-size games only (10k–100k concurrent players)

{
  "mode": "topGames",
  "minCurrentPlayers": 10000,
  "maxCurrentPlayers": 100000,
  "maxItems": 100
}

Use cases

• Market research — track which games are gaining or losing player share over time
• Esports & gaming media — surface trending titles and breakout hits for coverage
• Game developer competitive intelligence — benchmark your game's concurrent players against competitors in the same genre
• Investment / publisher analysis — monitor engagement trends for publicly traded gaming companies' titles
• Historical research — pull a decade-plus of monthly player-count history for any Steam game
• Dashboards & alerts — feed live player counts into a BI tool or Slack/Discord bot

FAQ

What's SteamCharts? An independent, community-run tracker of Steam's concurrent player counts, updated continuously by polling Steam's public player-count API. It's been running since 2012 and covers every game with any meaningful player base. See steamcharts.com/about.

How is this different from the official Steam Store API? SteamCharts adds historical trending, ranking, and month-over-month analysis on top of raw concurrent-player numbers — data the Steam Store API doesn't expose.

How fresh is the data? SteamCharts polls Steam continuously; current-player figures are typically only minutes old.

Why do some games have no historicalChartData? Very recently released or very low-traffic games may not have accumulated enough tracked months yet. monthlyHistory (the on-page summary table) usually still has entries.

Why does historicalChartData show several entries for the same recent date with different avgPlayers values? SteamCharts' underlying chart feed only settles into one data point per calendar month for periods further in the past — the most recent 1-3 months are still being sampled at daily or hourly resolution as new data arrives, so you'll see multiple same-month entries with slightly different values until that month rolls over and consolidates. Each entry also carries a full-precision timestamp so you can tell them apart and sort them chronologically — this is expected source behavior, not duplicated or bad data.

What does gain30d / gainPercent30d mean in search mode? The change in average daily concurrent players between the current 30-day window and the prior 30-day window — negative values mean a declining player base.

Does search require an exact title match? No — it's a partial, case-insensitive text match against tracked game names, resolved by SteamCharts' own search index. Match behavior isn't purely based on query length: some very short queries return results while some longer ones return none, depending on how SteamCharts indexes that term. If you get zero results, try a different or more complete word from the title.

What's the difference between peak24h/peakAllTime (gameDetails) and allTimePeakPlayers (topRecords)? They're the same underlying metric — topRecords surfaces only the games that currently hold a top-20 all-time-peak ranking across all of Steam, while gameDetails gives you the all-time peak for any specific game you look up.

Can I look up a game by name instead of App ID for gameDetails? Not directly — run search first to find the App ID, then pass it to gameDetails. This keeps ID lookups exact and avoids ambiguous name matches.

Is this affiliated with SteamCharts or Valve/Steam? No, this is a third-party actor using SteamCharts' public website data. It is not affiliated with, endorsed by, or sponsored by SteamCharts, Valve, or Steam.