公开数据接口

一个记录 Steam 在线人数和跨区售价的数据站:不卖游戏、不做导购,只把"某款游戏现在有多少人在玩、这一周是怎么变的、各商店地区卖多少钱"记下来并公开。

在线人数来自 Steam 公开的玩家接口(IPlayerService / 官方最多人玩榜),价格来自 Steam 各商店地区页面;本站负责采集(每小时更新)、存库、算口径、公开出来。 文件每小时重新导出一份,固定在每小时的第 50 分左右;每个文件里都带 updated_at,以它为准。 不需要 key、不需要登录,直接 HTTP GET 就是 JSON。

给 AI 工具读的同一份说明还有个纯文本版:/llms.txt,内容一字不差,只是排版不同。

有哪些文件

按需要挑着拉。前三份能回答绝大多数问题:先拿 games.json 对上 appid,再看 top.json 要此刻的状态, 要讲"这一周怎么走的"就取那款的 history/<appid>.json。

Steam 实时榜:此刻在 Steam 官方"最多人玩榜"里的游戏,按本站实测的当前在线排序

什么时候用:想知道"现在谁在最多人玩"、要一款游戏的当前在线/24H 峰值/较昨日/是否免费/好评率/类型标签——大多数问题这一份就够

顶层:updated_at / date / pool_size / tracked_size / all_size / blocked_excluded / total_players / games[] / top_risers[] / top_fallers[]

数组元素:rank / appid / pool_kind / name / name_en / unnamed / current / peak24h / change_pct / prev_same_time / vs_peak_pct / trend / new_entry / official_rank / ever_official / release_date / retired / at_max / spark / spark_dir / added_at / genres / publishers / tags / is_free / reviews / header_image

/data/tracked.json约 1.2 MB大文件,请缓存后用

官方榜外、本站仍在跟踪的那部分游戏:此刻不在 Steam 官方"最多人玩榜"里的长尾、从 Top100 掉下来的、以及新品观察池里的新游。与 top.json 合起来才是页面上那张"全部游戏榜",两份成员互斥,同一款不会在两边各排一次名次

什么时候用:要官方 Top100 之外的游戏就拉这份;要完整的全部游戏榜,把这份和 top.json 的 games 合起来按 current 重排

顶层:updated_at / date / pool_size / total_players / games[]

数组元素:games 与 top.json 同一套字段(rank / appid / pool_kind / name / name_en / current / peak24h / change_pct / vs_peak_pct / release_date / is_free / genres / tags / reviews / header_image / spark 等) / rank 是这份文件自己的序号(按 current 从高到低,取不到人数的排在末尾、值为 null),不等于页面上"全部游戏榜"显示的名次——页面名次要两份合并后重算 / official_rank 在这份里一律是 null:真在官方榜上的都在 top.json

/data/history/<appid>.json每款约 20~80 KB

单款游戏的时间序列:逐日日线 + 最近一段逐小时采样 + 商店资料 + 评价 + 各商店地区价(price,只含当前价)

什么时候用:要讲"这一周它是怎么走的"、要画图、要算连续几天在掉、要看各区的当前价——用这个,别去翻大文件

顶层:appid / name / name_en / added_at / current / all_time_max / pool_kind / retired / profile / reviews / price / days[] / hourly[] / rank / all_rank / peak24h / change_pct / header_image / header_image_big / header_image_src

数组元素:days: date / max / avg / last / samples / hourly: at / players / price: cn / cheapest / regions[](每区一条) / (价格只存当前值:涨价/打折会改写原条目,不保留历史分段)

/data/prices.json约 60 KB(含"还没核对到价格"的名单),全部付费游戏核对完之后约 250 KB

跨区价格:一份 rows 装下所有已核对到价格的游戏(国区价、核对时的最低区、折人民币、折扣、折人民币的差价;每行带国区价最后核对时间 checked_at,daily 表示它是否属于每天自动更新的那批,peak24h 是它近 24 小时在线峰值)。本站每天自动核对的是付费款里近 24 小时在线人数最高的一批(多少款见 daily_count 与 cadence 字段;核对哪些区见 reps 字段),其余款不会自动核对,只有访客在页面上点「查价」时才会查。/prices 不再排任何排行榜,只留两块:一块是这批每天更新的款(名单就是 daily 数组,按近 24 小时峰值从高到低),一块是手动查某一款;搜索能搜到 rows 与 pending 里的全部游戏。另有 pending 列出一次都还没核对到价格的款

什么时候用:要"这款现在多少钱、在不在打折、哪个区最便宜"——用这份;某一款的各区完整明细在 history/<appid>.json 的 price 里

顶层:updated_at / fx_date / priced / on_sale_count / daily_count / to_check / reps / cadence / daily[] / rows[] / pending[]

数组元素:daily: appid / peak24h(每天自动更新的那批,按峰值从高到低) / rows: appid / name / name_en / cn / cn_cny / off / checked_at / checked_label / checked_days_ago / stale / daily / peak24h / cheap_cc / cheap_name / cheap_cny / gap_pct / gap_cny / pending: appid / name / name_en(只有名字,价格还没核对到)

名字对照表:本站跟踪的每款游戏 appid ↔ 中文名 / 英文名

什么时候用:手上只有游戏名、要先拿到 appid 再查别的文件——从这份开始

顶层:数组,每项 appid / name / name_en

纪录墙:每款游戏在本站记到的最高在线,外加涨最多 / 跌最多 / 突然冲高三个切片。三块切片都是"一款一行"(取它最猛的那一天),行里带 date 与 prev_date 供核对

什么时候用:要"谁破了纪录""这周谁掉得最狠"这类对比

顶层:updated_at / records[] / recent[] / gains[] / losses[] / spikes[]

数组元素:records/recent: appid / name / name_en / record_players / record_date / current / vs_record_pct / gains/losses/spikes: appid / name / date / prev_date / players / prev_players / pct(date 是异动那天,players 是当天峰值)

涨跌榜四个档:实时 / 昨日 / 近 7 天 / 近 30 天,每档一份涨榜和跌榜

什么时候用:要"最近谁在涨谁在掉",且想指定比较窗口

顶层:updated_at / date / tabs.live / tabs.daily / tabs.weekly / tabs.monthly

数组元素:每个 tab: label / from / to / prev_from / prev_to / games[]

/data/just-released.json约 210 KB大文件,请缓存后用

最新上架:按发售日期分组的新游和它们的首周人数

什么时候用:关心"刚上线的游戏表现怎么样"

顶层:updated_at / latest / days[] / by_date

/data/new-games.json约 1.3 MB大文件,请缓存后用

新游榜:观察池里所有新游戏的完整榜单与多窗口数据

什么时候用:只有要做全量新游分析时才拉;日常用 just-released.json 就够

顶层:updated_at / window_days / cutoff / games[] / periods

/data/rankings.json约 2 MB大文件,请缓存后用

日榜 / 周榜 / 月榜的完整榜单(每期的区间峰值、均值、覆盖天数)

什么时候用:要按自然周期回看排名。文件大,请缓存后使用,别反复全量拉

顶层:updated_at / periods.daily / periods.weekly / periods.monthly

数组元素:每个 period: label / from / to / games[]

总在线趋势:本站跟踪的游戏每日峰值在线合计,两条口径——fixed 是"区间内每天都有足量采样的同一批游戏"(可比,反映真实热度变化),pool 是当日全部游戏合计(会随收录数量增长而抬高,只作参考)

什么时候用:要"整体热度这一段时间是涨还是掉"就用 fixed 那条;只有想知道今天合计多少、跟踪了多少款才看 pool

顶层:updated_at / basket_size / dates[] / fixed.max[] / fixed.avg[] / pool.max[] / pool.games[] / complete_dates[]

数组元素:fixed.max / fixed.avg / pool.max / pool.games 四个数组都与 dates 一一对应,那天没记满就是 null / complete_dates: date / games / avg_samples——这一天全站平均记到的点数,够到"按档该记的点数"的四分之一才算一个有效交易日(全站每小时一轮时就是平均 6 次;各档多久记一次见采样节奏),曲线只连这些天,最多回看 90 天 / basket_size 是"可比游戏数":区间内每一天都有足量采样的那批,fixed 就是把它们的当日峰值相加

4 条口径(引用前必读)

这三条写错,数字本身没错,结论却是错的——也是我们在别处最常看到的错法。

  1. 1. "历史最高"一律是"本站收录以来"

    at_max / all_time_max 是从本站开始跟踪这款游戏那天算的,不是 Steam 官方全时段最高。这款游戏在我们收录之前可能火得多得多。要引用"新高",请写成"本站收录以来新高",收录起点看 added_at。

  2. 2. 两个百分比不是一回事

    change_pct 是"此刻在线 vs 昨天同一时刻",会随几点看而变;vs_peak_pct 是"今天已经出现的日峰值 vs 昨天的日峰值",两端都是日峰值,正数意味着今天已经破了昨天的纪录。引用时必须说清用的哪一个。

  3. 3. 拿不到就是 null,不是 0

    字段为 null 表示这个数本站当前取不到(商店资料还没同步、昨日同一时刻没有采样、这款游戏还没被跟踪),不能当成 0 人在线,也不能据此下判断。

  4. 4. 价格是"最后一次核对到的",不是此刻的商店价

    prices.json 和游戏页面上那份价,是本站逐区核对到的最新结果:每一组「款 × 区」都记着最后一次核对时间;本站每天自动核对付费款里在线人数最高的一批(多少款、最近一轮多久,见 prices.json 的 cadence 字段),其余款不会自动再核,页面上的「查价」按钮可以现查一次;本站核对的是商店的全部独立定价地区(区名单在 prices.json 的 reps 字段),所以每一款的"最低价区"是这些地区里最低的,不一定是全世界最低。打折本身是限时活动。折人民币按 fx_date 那天的汇率,汇率一变"最低区"就可能换人。引用价格请写成"截至本站某日核对",别写成"现在卖多少钱";另外低价区通常需要当地账号,跨区交易有被 Steam 限制的风险。

    本站此刻:每天自动核对付费款里在线人数最高的约 100 款,其余 6457 款不会自动再核;自动核对的那批最久 1 天前核过。

字段都是怎么算的

解释和站内各处用的是同一份名词表(首页、榜单页、游戏页面上看到的解释,和这里一字不差), 所以不会出现"页面上的当前在线"和"JSON 里的 current"是两回事。

字段出现在含义
updated_at每个文件更新:这批数字最后一次记录完成的时间(北京时间)。 本站计划每小时记一轮,机器关机或网络中断的那一小时会缺,缺的位置留空不补值——所以这个时刻只保证"不晚于它就没有更新的数据",不保证一定是一小时前。
currenttop / history / records当前在线:最近一次记录到的同时在线人数(来自 Steam 官方)。 本站按采样节奏逐款记录(现在多久记一次、哪款在哪一档,见"采样节奏"),两次记录之间真实人数一直在变,所以这是"刚刚"的数,不是此刻的数。
peak24htop24H 峰值:从这一刻往前数 24 小时内,采样到的最高同时在线人数,每小时滚动更新。 注意:它不是"昨日峰值"——昨日峰值指昨天 0 点到 24 点那个自然日的最高值(日榜用的是那个口径)。
change_pcttop见上面「4 条口径」第 2 条:两个百分比不是一回事。
vs_peak_pcttop见上面「4 条口径」第 2 条:两个百分比不是一回事。
prev_same_timetop昨天同一时刻本站采到的在线人数,用来算 change_pct;那天那个时间没采样就是 null。
trendtop走势箭头:箭头方向跟"较昨日"的符号走:涨为↑、跌为↓、持平或不可比为 –。 数字为"较昨日",详见该词条。
at_maxtop(history 里同义字段叫 all_time_max)见上面「4 条口径」第 1 条:"历史最高"一律是"本站收录以来"。
added_attop / history本站第一次收录这款游戏的时间。它决定了 at_max 的起点,所以引用"新高"前先看这个。
pool_kindtop / historymain=正式池,进实时榜和全部游戏榜;new=新品观察池,只进新游榜和最新上架。
new_entrytop新上榜:本站最近才第一次收录到这款游戏,所以没有可对比的历史数据。 注意它不等于"新发售":发售几年的游戏,只要本站刚把它加进跟踪名单,也会先标一段时间。
official_ranktopSteam 官方榜:Steam 自己公布的"最多人玩榜",只有前 100 名,本站每小时记一次这份名单。 官方给的是名单、名次和一个按周汇总的峰值人数,不是实时在线;所以本站再逐款记下当前在线人数来排名。
ever_officialtop曾进官方榜:这款游戏上过 Steam 官方"最多人玩榜"前 100,后来掉出来了,本站仍在逐小时记录它的人数。 有这个标记 = 它是"从官方榜掉下来"的那一类,不是我们另外找来的长尾。
release_datetop / history.profile上线时间:Steam 商店页公开的发售日期,由本站每日同步。 抢先体验(Early Access)的游戏取"最早开启抢先体验"和"正式版发售"两个日期里更早的那个,所以这里的日期通常比正式版早。 个别游戏 Steam 没公开日期(写"即将推出"),这一格就是空的。 全部游戏榜上"上线"那一档筛选就是按这一格算:今天 / 近 3 天 / 近 7 天按整天数、近 1、2、3 个月按日历月回退,窗口两头都含当天;这一格为空的游戏在任何时间档里都不会出现。
retiredtop / history已停止跟踪:连续 30 天在线人数都是 0 的游戏,本站不再跟踪,也不进任何榜单(首页、榜单、搜索、分类榜都看不到)。 历史数据仍保留,所以直接访问它自己的页面还能看到过去的曲线。
is_freetop / history.profile免费开玩 / 买断制:「免费开玩」= Steam 商店给这款打的免费标记,下载不要钱(道具、季票另算)。 「买断制」= Steam 标了它需要购买才能玩。 数据来自 Steam 商店页,本站每天和商店对一次;刚收录、或商店暂时查不到的游戏落在「本站还没查到」里,不会被硬算成买断制。 所以选「要买(买断制)」时看到的款数会比总数少一截,缺的就是还没查到的。
genrestop / history.profile官方类型:Steam 商店页给这款游戏打的官方类型标签(动作、冒险、角色扮演、大型多人在线…),一共就十几个,一款可以有好几个。 筛"官方类型"时,一款只要有这个标签就会出现,所以在"动作"里出现过的游戏,在"角色扮演"里也可能出现,各类型款数相加会大于总数。 想要更细的分类(第一人称射击、开放世界、沙盒…)用旁边的"社区标签"筛。 注意:商店还没同步到类型的游戏不会被任何类型筛出来(榜单下方那行小字写明缺了多少款)。
tagstop / history.profile社区标签:Steam 商店页"热门用户自定义标签"的前几名,是玩家自己贴的,比官方类型细得多:第一人称射击、开放世界、沙盒、 PvE、生存 crafting… 游戏名字后面的小标签就是这个(排在官方类型后面,和官方类型重复的词不重复显示),鼠标停上去能看到它的全部标签。 同一款游戏可以有很多个标签,所以按标签筛出来的款数相加会大于总数。 注意:标签是本站每天从商店页抓的,少数游戏还没抓到(榜单下方那行小字写明缺多少款),选标签时它们不会出现。
reviewstop / history好评率:好评率 = 好评数 ÷ 评测总数 × 100%,数据来自 Steam 商店页的评测汇总(全部语言、不分平台)。 门槛:评测总数不足 1000 条的不参与"好评率最高"排名,不足 300 条的不参与"好评率最低"排名,都不进这两块榜——几十条评测的游戏,几个差评就能把百分比甩出去一大截,排出来没有意义。 差评率就是 100% 减好评率,所以"差评率最高"和"好评率最低"是同一件事的两种说法,格子里一律显示好评率。 本站每小时更新 40 款,全部游戏大约一天轮完一圈,所以这里的数字最多比商店晚一天。
days[].maxhistory当日峰值:这一个自然日(北京时间 0 点到 24 点)里采到的最高同时在线人数。 和"24H 峰值"的区别:那是从现在往前数 24 小时的滚动窗口,这个是按天切开的整日最高值。
days[].avghistory当日均值:当日各轮采样在线人数的平均值,反映这一天的常态水位;峰值高但均值低,说明只有少数时段冲得高。
days[].lasthistory当日最后:这一天最后一轮采样的在线人数,代表它当天收工时的状态;和峰值的差,能看出当天晚高峰离收盘有多远。
days[].sampleshistory采样次数:这一天实际抓到数据的点数:每小时测的那档满打满算 24 个点、每 2 小时轮一次的那档 12 个点、每天补测一轮的那档 1 个点(哪一款在哪一档见"采样节奏")。 少于应有的点数有三种原因:关机/维护/网络中断、这一轮没轮到这款游戏、分档时它那天本来就只测一次;均值一律按实际有数据的点数算。
hourly[]history每小时线:把每次采到的在线人数逐点连成的曲线,只保留最近 7 天。热门游戏一小时一个点;开了分档采样后,其余档位的点会更稀(间隔见"采样节奏")。 更早的历史只能看每日线:每天存当日峰值、均值和采样次数。
spark / spark_dirtop最近若干天日峰值折成的 0~9 档位串('-' 表示那天没数据)和首尾对比出的涨跌,页面上那条小曲线就是它。只要数值就别用它,用 history 里的 days。
pricehistory中国区价格:Steam 中国商店地区的售价。 显示的是本站最近一次核对到的价,不是实时价:本站每天只自动核对付费款里在线人数最高的一批,其余款不自动核对,只在有人点「查价」时现查(每天核多少款、实测多久轮到一次,比价页和 prices.json 的 cadence 字段写着)。正在打折时同时给出原价(划线)和折扣率。 这是 Steam 自己定的价,本站不改价、不卖游戏、也没有任何购买链接。
price.cn / price.cheapest / price.regions[]history国区那一条、今日最低区那一条、以及已核对到的每个商店地区一条(cc / name / cur / final / initial / off / cny)。没核对过的区不在数组里,不等于那个区没卖。
fx_dateprices汇率折算:各商店地区的当地价统一换成人民币,才能直接比大小。 页面会写明用的是哪一天的汇率——汇率一变,最低区就可能换人,所以日期必须标出来。 取不到汇率时只列各区的当地原价、不排最低,也不会拿旧汇率冒充当天的数。
cn / offpricescn=国区当前售价(人民币,元);off=此刻的折扣百分比,0 表示没打折。
cheap_cc / cheap_name / cheap_cnyprices最近一次核对时的最低区(在已比较的全部商店地区里)代码、中文名和折成人民币后的价。最低区可能就是国区本身——那时 cheap_cc="cn"、gap_pct=0,不是缺数据。
gap_pctprices国区价比最近一次核对的最低区贵百分之几;0 表示国区已经是所有已核对区里最低的;null 表示这一款的国区价当时折不出人民币(缺汇率或国区价没核到),页面显示"折不出人民币",不会拿 0 冒充。
gap_cnyprices国区价减去最近一次核对的最低区价,单位人民币元。gap_pct 只看便宜了几成,gap_cny 只看省多少钱;最低区就是国区时两个都是 0,国区折不出人民币时两个都是 null(不是 0)。
priced / on_sale_count / to_checkpricespriced=已核对到价格的游戏款数(= rows 长度);on_sale_count=其中最后一次核对时国区在打折的款数(全量);to_check=应核对款数(没退场、不是免费开玩的全部游戏)。本站每天自动核对的只有 daily_count 那么多款,其余款不会自动核对,要等访客点「查价」:所以"某款不在 rows 里"只代表它一次都还没核对到,不代表它没卖或没打折;"某款没进每日更新那块"只代表它不在按在线人数挑出的那批里,搜索仍能找到。
daily[] / daily_countprices每天自动核对的那批游戏(名单跟近 24 小时在线峰值从高到低取,取多少款看容量),数组每项只有 appid 和 peak24h;daily_count 就是这批的款数。/prices 第一块按这个顺序列出它们。
rows[].daily / rows[].peak24hpricesdaily=这款是否在每天自动更新的那批里(也就是 daily 数组里有没有它);peak24h=近 24 小时在线峰值,每天那批就是按它从高到低挑的。
rows[]prices所有已核对到价格的游戏,默认按国区价从低到高排。/prices 不另存榜单副本:第一块直接照着 daily 数组列,第二块是手动查一款;rows 同时给这两块做搜索底表。
pending[]prices还没核对到价格的款(只有 appid 和名字)。列出来是为了让玩家搜得到自己的那款,而不是搜出来一句"没搜到";这类款在 /prices 手动查询块和游戏页上都能点「查价」现查一次。
cadenceprices自动核对的实测节奏(价格工人每轮从核对记录现算后落盘,不是写死的计划):dailyGames=每天自动核对的款数,dailyPairs=这些款一轮要核对多少组「款 × 区」,restGames=不自动核对、只在访客点「查价」时查的款数,dailyDays / dailyMaxDays=自动那批实测平均 / 最久多少天轮到一次,restDays=其余款最后一次核对距今的平均天数,neverPairs=一次都还没核对到的区组数。
repsprices本站核对价格的商店地区名单(regions):所有款都按这一份核对,就是商店的全部独立定价地区。"最低价区"是这些地区里最低的那个;名单以外的地区不在本站比较范围内,不等于那里没卖。
total_playerstop / tracked总在线:把本站当前跟踪的所有游戏(全部游戏榜)此刻的在线人数加起来。 只是本站跟踪的这批游戏的合计,不等于 Steam 全站人数;已停止跟踪的游戏不计入。
pool_size / tracked_size / all_size / blocked_excludedtoppool_size=此刻实时榜有多少款(官方榜里本站能取到人数的);tracked_size=本站在逐小时跟踪的款数;all_size=库里收录过的全部条目数;blocked_excluded=已被识别为非游戏本体(DLC/原声带/皮肤包)因而挡在榜外的款数。几个数不一样是正常的。

这些数据我们没有

列出来是怕你(或你用的 AI)拿不到就自己补。下面这些本站一个字段都没有,问到也答不了:

本站立场

在线人数是一个时刻的快照,不是一款游戏的生死判决。同一时刻五千人和一小时后的五千人,不一定是同一批人;靠几千个固定玩家也能活很多年的小品类多的是。请不要拿单日读数写"这游戏凉了"。

使用与引用

这份说明由 web/lib/data-api.mjs 一处生成:本页和 /llms.txt 都从它渲染, 所以不会出现"给人看一套、给机器看一套"。有出入以本页为准,并欢迎告诉我们。

haha1.cn蒸汽榜 · 数据来自 Steam 公开接口 · 名词解释与免责