HowLongToBeat Data API

Access video game completion times from HowLongToBeat. Search games, get detailed playtime estimates, per-platform breakdowns, DLC data, and user reviews.

原始信息汇总

HowLongToBeat Data API 数据集概述

基本信息

• 数据集名称: HowLongToBeat Data API
• 提供方: elis-lab
• 类别: Gaming
• 版本: v1 (current)

数据集描述

这是一个用于访问 HowLongToBeat.com 视频游戏通关时间的非官方 API。该网站是互联网上最大的视频游戏通关时间数据库。此 API 可用于搜索游戏、获取详细的游戏时长估计、按平台细分的数据、DLC 数据以及用户评论。

主要功能

• 通过标题搜索游戏。
• 获取完整的游戏详情。
• 获取按平台细分的通关数据。
• 获取 DLC 及相关内容数据。

端点详情

1. GET /search

• 描述: 按标题搜索游戏。
• 必需参数:
  • q (string): 搜索查询（游戏标题）。
• 可选参数:
  • page (integer): 页码，默认值为 1。
  • size (integer): 每页结果数，默认值为 20。
  • platform (string): 按平台筛选（例如 "PC", "Nintendo Switch"）。
  • sortBy (string): 排序方式，可选 popular、name、rating、length，默认值为 popular。
  • modifier (string): DLC 过滤器，可选 none、only_dlc、hide_dlc。

2. GET /game/{id}

• 描述: 通过 ID 获取完整的游戏详情。
• 必需参数:
  • id (integer): HowLongToBeat 游戏 ID（来自搜索结果）。

3. GET /game/{id}/platforms

• 描述: 获取按平台细分的通关数据。
• 必需参数:
  • id (integer): HowLongToBeat 游戏 ID。

4. GET /game/{id}/dlc

• 描述: 获取 DLC 数据。
• 必需参数:
  • id (integer): HowLongToBeat 游戏 ID。

响应数据结构

通关时间

所有通关时间均以小时为单位返回（四舍五入到 1 位小数），并包含用户报告数量：

• mainStory: 仅主线故事/战役。
• mainPlusExtras: 主线故事 + 支线内容。
• completionist: 100% 完成度。
• allStyles: 所有游戏风格的平均值。

游戏详情包含

• 基本信息：名称、图片、类型、平台、开发商、发行商、流派、描述。
• 发布日期：全球、北美、欧洲、日本。
• 年龄分级：ESRB、PEGI、CERO。
• 详细的通关时间范围：每个类别的低值、高值、平均值、中位数。
• 速通时间：any% 和 100%。
• 合作与多人游戏时间投入。
• 用户统计：正在玩、待玩列表、已完成、放弃、重玩、评分。
• 用于交叉引用的 Steam ID。
• 按平台细分的数据。
• DLC/扩展包关系。
• 用户评分分布。

分页

搜索结果支持分页。使用 page 和 size 参数。 响应包含：

• count: 总结果数。
• page: 当前页码。
• pageTotal: 总页数。
• pageSize: 每页结果数。

错误代码

• 200: 成功。
• 422: 验证错误（参数缺失或无效）。
• 404: 路由未找到。
• 502: 上游错误（HowLongToBeat 不可用）。

使用提示

• 使用搜索功能查找游戏 ID，然后使用这些 ID 调用详情、平台、DLC 端点。
• steamId 字段可用于与 Steam API 进行交叉引用。
• rating 是基于用户评分的百分制分数。
• 设置 modifier=hide_dlc 以在搜索结果中排除 DLC。
• 通关时间为 0 表示数据不足。

订阅计划

• BASIC: $0.00 / 月
• PRO: $10.00 / 月
• ULTRA: $35.00 / 月
• MEGA: $75.00 / 月

搜集汇总

背景与挑战

背景概述

该数据集为HowLongToBeat.com的非官方API，提供视频游戏通关时间查询服务，支持通过搜索获取游戏ID，并基于ID查询详细游戏信息、平台特定数据和DLC内容。API包含多个端点，返回数据涵盖游戏基本信息、通关时间统计、用户评分等内容。