公开数据接口
一个记录 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
官方榜外、本站仍在跟踪的那部分游戏:此刻不在 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
单款游戏的时间序列:逐日日线 + 最近一段逐小时采样 + 商店资料 + 评价 + 各商店地区价(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[](每区一条) / (价格只存当前值:涨价/打折会改写原条目,不保留历史分段)
跨区价格:一份 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[]
最新上架:按发售日期分组的新游和它们的首周人数
什么时候用:关心"刚上线的游戏表现怎么样"
顶层:updated_at / latest / days[] / by_date
新游榜:观察池里所有新游戏的完整榜单与多窗口数据
什么时候用:只有要做全量新游分析时才拉;日常用 just-released.json 就够
顶层:updated_at / window_days / cutoff / games[] / periods
日榜 / 周榜 / 月榜的完整榜单(每期的区间峰值、均值、覆盖天数)
什么时候用:要按自然周期回看排名。文件大,请缓存后使用,别反复全量拉
顶层: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. "历史最高"一律是"本站收录以来"
at_max / all_time_max 是从本站开始跟踪这款游戏那天算的,不是 Steam 官方全时段最高。这款游戏在我们收录之前可能火得多得多。要引用"新高",请写成"本站收录以来新高",收录起点看 added_at。
2. 两个百分比不是一回事
change_pct 是"此刻在线 vs 昨天同一时刻",会随几点看而变;vs_peak_pct 是"今天已经出现的日峰值 vs 昨天的日峰值",两端都是日峰值,正数意味着今天已经破了昨天的纪录。引用时必须说清用的哪一个。
3. 拿不到就是 null,不是 0
字段为 null 表示这个数本站当前取不到(商店资料还没同步、昨日同一时刻没有采样、这款游戏还没被跟踪),不能当成 0 人在线,也不能据此下判断。
4. 价格是"最后一次核对到的",不是此刻的商店价
prices.json 和游戏页面上那份价,是本站逐区核对到的最新结果:每一组「款 × 区」都记着最后一次核对时间;本站每天自动核对付费款里在线人数最高的一批(多少款、最近一轮多久,见 prices.json 的 cadence 字段),其余款不会自动再核,页面上的「查价」按钮可以现查一次;本站核对的是商店的全部独立定价地区(区名单在 prices.json 的 reps 字段),所以每一款的"最低价区"是这些地区里最低的,不一定是全世界最低。打折本身是限时活动。折人民币按 fx_date 那天的汇率,汇率一变"最低区"就可能换人。引用价格请写成"截至本站某日核对",别写成"现在卖多少钱";另外低价区通常需要当地账号,跨区交易有被 Steam 限制的风险。
本站此刻:每天自动核对付费款里在线人数最高的约 100 款,其余 6457 款不会自动再核;自动核对的那批最久 1 天前核过。
字段都是怎么算的
解释和站内各处用的是同一份名词表(首页、榜单页、游戏页面上看到的解释,和这里一字不差), 所以不会出现"页面上的当前在线"和"JSON 里的 current"是两回事。
| 字段 | 出现在 | 含义 |
|---|---|---|
| updated_at | 每个文件 | 更新:这批数字最后一次记录完成的时间(北京时间)。 本站计划每小时记一轮,机器关机或网络中断的那一小时会缺,缺的位置留空不补值——所以这个时刻只保证"不晚于它就没有更新的数据",不保证一定是一小时前。 |
| current | top / history / records | 当前在线:最近一次记录到的同时在线人数(来自 Steam 官方)。 本站按采样节奏逐款记录(现在多久记一次、哪款在哪一档,见"采样节奏"),两次记录之间真实人数一直在变,所以这是"刚刚"的数,不是此刻的数。 |
| peak24h | top | 24H 峰值:从这一刻往前数 24 小时内,采样到的最高同时在线人数,每小时滚动更新。 注意:它不是"昨日峰值"——昨日峰值指昨天 0 点到 24 点那个自然日的最高值(日榜用的是那个口径)。 |
| change_pct | top | 见上面「4 条口径」第 2 条:两个百分比不是一回事。 |
| vs_peak_pct | top | 见上面「4 条口径」第 2 条:两个百分比不是一回事。 |
| prev_same_time | top | 昨天同一时刻本站采到的在线人数,用来算 change_pct;那天那个时间没采样就是 null。 |
| trend | top | 走势箭头:箭头方向跟"较昨日"的符号走:涨为↑、跌为↓、持平或不可比为 –。 数字为"较昨日",详见该词条。 |
| at_max | top(history 里同义字段叫 all_time_max) | 见上面「4 条口径」第 1 条:"历史最高"一律是"本站收录以来"。 |
| added_at | top / history | 本站第一次收录这款游戏的时间。它决定了 at_max 的起点,所以引用"新高"前先看这个。 |
| pool_kind | top / history | main=正式池,进实时榜和全部游戏榜;new=新品观察池,只进新游榜和最新上架。 |
| new_entry | top | 新上榜:本站最近才第一次收录到这款游戏,所以没有可对比的历史数据。 注意它不等于"新发售":发售几年的游戏,只要本站刚把它加进跟踪名单,也会先标一段时间。 |
| official_rank | top | Steam 官方榜:Steam 自己公布的"最多人玩榜",只有前 100 名,本站每小时记一次这份名单。 官方给的是名单、名次和一个按周汇总的峰值人数,不是实时在线;所以本站再逐款记下当前在线人数来排名。 |
| ever_official | top | 曾进官方榜:这款游戏上过 Steam 官方"最多人玩榜"前 100,后来掉出来了,本站仍在逐小时记录它的人数。 有这个标记 = 它是"从官方榜掉下来"的那一类,不是我们另外找来的长尾。 |
| release_date | top / history.profile | 上线时间:Steam 商店页公开的发售日期,由本站每日同步。 抢先体验(Early Access)的游戏取"最早开启抢先体验"和"正式版发售"两个日期里更早的那个,所以这里的日期通常比正式版早。 个别游戏 Steam 没公开日期(写"即将推出"),这一格就是空的。 全部游戏榜上"上线"那一档筛选就是按这一格算:今天 / 近 3 天 / 近 7 天按整天数、近 1、2、3 个月按日历月回退,窗口两头都含当天;这一格为空的游戏在任何时间档里都不会出现。 |
| retired | top / history | 已停止跟踪:连续 30 天在线人数都是 0 的游戏,本站不再跟踪,也不进任何榜单(首页、榜单、搜索、分类榜都看不到)。 历史数据仍保留,所以直接访问它自己的页面还能看到过去的曲线。 |
| is_free | top / history.profile | 免费开玩 / 买断制:「免费开玩」= Steam 商店给这款打的免费标记,下载不要钱(道具、季票另算)。 「买断制」= Steam 标了它需要购买才能玩。 数据来自 Steam 商店页,本站每天和商店对一次;刚收录、或商店暂时查不到的游戏落在「本站还没查到」里,不会被硬算成买断制。 所以选「要买(买断制)」时看到的款数会比总数少一截,缺的就是还没查到的。 |
| genres | top / history.profile | 官方类型:Steam 商店页给这款游戏打的官方类型标签(动作、冒险、角色扮演、大型多人在线…),一共就十几个,一款可以有好几个。 筛"官方类型"时,一款只要有这个标签就会出现,所以在"动作"里出现过的游戏,在"角色扮演"里也可能出现,各类型款数相加会大于总数。 想要更细的分类(第一人称射击、开放世界、沙盒…)用旁边的"社区标签"筛。 注意:商店还没同步到类型的游戏不会被任何类型筛出来(榜单下方那行小字写明缺了多少款)。 |
| tags | top / history.profile | 社区标签:Steam 商店页"热门用户自定义标签"的前几名,是玩家自己贴的,比官方类型细得多:第一人称射击、开放世界、沙盒、 PvE、生存 crafting… 游戏名字后面的小标签就是这个(排在官方类型后面,和官方类型重复的词不重复显示),鼠标停上去能看到它的全部标签。 同一款游戏可以有很多个标签,所以按标签筛出来的款数相加会大于总数。 注意:标签是本站每天从商店页抓的,少数游戏还没抓到(榜单下方那行小字写明缺多少款),选标签时它们不会出现。 |
| reviews | top / history | 好评率:好评率 = 好评数 ÷ 评测总数 × 100%,数据来自 Steam 商店页的评测汇总(全部语言、不分平台)。 门槛:评测总数不足 1000 条的不参与"好评率最高"排名,不足 300 条的不参与"好评率最低"排名,都不进这两块榜——几十条评测的游戏,几个差评就能把百分比甩出去一大截,排出来没有意义。 差评率就是 100% 减好评率,所以"差评率最高"和"好评率最低"是同一件事的两种说法,格子里一律显示好评率。 本站每小时更新 40 款,全部游戏大约一天轮完一圈,所以这里的数字最多比商店晚一天。 |
| days[].max | history | 当日峰值:这一个自然日(北京时间 0 点到 24 点)里采到的最高同时在线人数。 和"24H 峰值"的区别:那是从现在往前数 24 小时的滚动窗口,这个是按天切开的整日最高值。 |
| days[].avg | history | 当日均值:当日各轮采样在线人数的平均值,反映这一天的常态水位;峰值高但均值低,说明只有少数时段冲得高。 |
| days[].last | history | 当日最后:这一天最后一轮采样的在线人数,代表它当天收工时的状态;和峰值的差,能看出当天晚高峰离收盘有多远。 |
| days[].samples | history | 采样次数:这一天实际抓到数据的点数:每小时测的那档满打满算 24 个点、每 2 小时轮一次的那档 12 个点、每天补测一轮的那档 1 个点(哪一款在哪一档见"采样节奏")。 少于应有的点数有三种原因:关机/维护/网络中断、这一轮没轮到这款游戏、分档时它那天本来就只测一次;均值一律按实际有数据的点数算。 |
| hourly[] | history | 每小时线:把每次采到的在线人数逐点连成的曲线,只保留最近 7 天。热门游戏一小时一个点;开了分档采样后,其余档位的点会更稀(间隔见"采样节奏")。 更早的历史只能看每日线:每天存当日峰值、均值和采样次数。 |
| spark / spark_dir | top | 最近若干天日峰值折成的 0~9 档位串('-' 表示那天没数据)和首尾对比出的涨跌,页面上那条小曲线就是它。只要数值就别用它,用 history 里的 days。 |
| price | history | 中国区价格:Steam 中国商店地区的售价。 显示的是本站最近一次核对到的价,不是实时价:本站每天只自动核对付费款里在线人数最高的一批,其余款不自动核对,只在有人点「查价」时现查(每天核多少款、实测多久轮到一次,比价页和 prices.json 的 cadence 字段写着)。正在打折时同时给出原价(划线)和折扣率。 这是 Steam 自己定的价,本站不改价、不卖游戏、也没有任何购买链接。 |
| price.cn / price.cheapest / price.regions[] | history | 国区那一条、今日最低区那一条、以及已核对到的每个商店地区一条(cc / name / cur / final / initial / off / cny)。没核对过的区不在数组里,不等于那个区没卖。 |
| fx_date | prices | 汇率折算:各商店地区的当地价统一换成人民币,才能直接比大小。 页面会写明用的是哪一天的汇率——汇率一变,最低区就可能换人,所以日期必须标出来。 取不到汇率时只列各区的当地原价、不排最低,也不会拿旧汇率冒充当天的数。 |
| cn / off | prices | cn=国区当前售价(人民币,元);off=此刻的折扣百分比,0 表示没打折。 |
| cheap_cc / cheap_name / cheap_cny | prices | 最近一次核对时的最低区(在已比较的全部商店地区里)代码、中文名和折成人民币后的价。最低区可能就是国区本身——那时 cheap_cc="cn"、gap_pct=0,不是缺数据。 |
| gap_pct | prices | 国区价比最近一次核对的最低区贵百分之几;0 表示国区已经是所有已核对区里最低的;null 表示这一款的国区价当时折不出人民币(缺汇率或国区价没核到),页面显示"折不出人民币",不会拿 0 冒充。 |
| gap_cny | prices | 国区价减去最近一次核对的最低区价,单位人民币元。gap_pct 只看便宜了几成,gap_cny 只看省多少钱;最低区就是国区时两个都是 0,国区折不出人民币时两个都是 null(不是 0)。 |
| priced / on_sale_count / to_check | prices | priced=已核对到价格的游戏款数(= rows 长度);on_sale_count=其中最后一次核对时国区在打折的款数(全量);to_check=应核对款数(没退场、不是免费开玩的全部游戏)。本站每天自动核对的只有 daily_count 那么多款,其余款不会自动核对,要等访客点「查价」:所以"某款不在 rows 里"只代表它一次都还没核对到,不代表它没卖或没打折;"某款没进每日更新那块"只代表它不在按在线人数挑出的那批里,搜索仍能找到。 |
| daily[] / daily_count | prices | 每天自动核对的那批游戏(名单跟近 24 小时在线峰值从高到低取,取多少款看容量),数组每项只有 appid 和 peak24h;daily_count 就是这批的款数。/prices 第一块按这个顺序列出它们。 |
| rows[].daily / rows[].peak24h | prices | daily=这款是否在每天自动更新的那批里(也就是 daily 数组里有没有它);peak24h=近 24 小时在线峰值,每天那批就是按它从高到低挑的。 |
| rows[] | prices | 所有已核对到价格的游戏,默认按国区价从低到高排。/prices 不另存榜单副本:第一块直接照着 daily 数组列,第二块是手动查一款;rows 同时给这两块做搜索底表。 |
| pending[] | prices | 还没核对到价格的款(只有 appid 和名字)。列出来是为了让玩家搜得到自己的那款,而不是搜出来一句"没搜到";这类款在 /prices 手动查询块和游戏页上都能点「查价」现查一次。 |
| cadence | prices | 自动核对的实测节奏(价格工人每轮从核对记录现算后落盘,不是写死的计划):dailyGames=每天自动核对的款数,dailyPairs=这些款一轮要核对多少组「款 × 区」,restGames=不自动核对、只在访客点「查价」时查的款数,dailyDays / dailyMaxDays=自动那批实测平均 / 最久多少天轮到一次,restDays=其余款最后一次核对距今的平均天数,neverPairs=一次都还没核对到的区组数。 |
| reps | prices | 本站核对价格的商店地区名单(regions):所有款都按这一份核对,就是商店的全部独立定价地区。"最低价区"是这些地区里最低的那个;名单以外的地区不在本站比较范围内,不等于那里没卖。 |
| total_players | top / tracked | 总在线:把本站当前跟踪的所有游戏(全部游戏榜)此刻的在线人数加起来。 只是本站跟踪的这批游戏的合计,不等于 Steam 全站人数;已停止跟踪的游戏不计入。 |
| pool_size / tracked_size / all_size / blocked_excluded | top | pool_size=此刻实时榜有多少款(官方榜里本站能取到人数的);tracked_size=本站在逐小时跟踪的款数;all_size=库里收录过的全部条目数;blocked_excluded=已被识别为非游戏本体(DLC/原声带/皮肤包)因而挡在榜外的款数。几个数不一样是正常的。 |
这些数据我们没有
列出来是怕你(或你用的 AI)拿不到就自己补。下面这些本站一个字段都没有,问到也答不了:
- 第三方商店和 Key 站的售价(只记 Steam 各商店地区页面上的价)
- 销量、份数、营收
- 玩家画像(性别、年龄、地区分布)
- 留存率、日活月活(只有某一刻的在线人数,不是去重人数)
- 评价数量随时间的变化(只有当前好评率和评价总数)
- 游戏内数据(段位、副本、在线模式人数细分)
本站立场
在线人数是一个时刻的快照,不是一款游戏的生死判决。同一时刻五千人和一小时后的五千人,不一定是同一批人;靠几千个固定玩家也能活很多年的小品类多的是。请不要拿单日读数写"这游戏凉了"。
使用与引用
- 直接 GET,无需鉴权;请带正常的 User-Agent,方便我们认出是哪类客户端在来。
- 同一份数据不会比每小时变得更快(开了分档采样后,多数游戏要每几小时才变一次,见采样节奏),**请缓存至少 1 小时**;每分钟重复拉同一份没有意义,只会挤占带宽(这台服务器带宽很小)。
- 标了"大文件"的三份(rankings / new-games / just-released)动辄上 MB,能不用就不用,要用请缓存。
- 引用请注明"数据来源:haha1.cn蒸汽榜"并带上这一页或对应榜单的链接——不为别的,只为了别人看到数字能找到原始口径。
- 本站数据本身也来自 Steam 公开接口,任何人都可以自己去查;我们不主张独占,也不收费。
这份说明由 web/lib/data-api.mjs 一处生成:本页和 /llms.txt 都从它渲染, 所以不会出现"给人看一套、给机器看一套"。有出入以本页为准,并欢迎告诉我们。
haha1.cn蒸汽榜 · 数据来自 Steam 公开接口 · 名词解释与免责
