HowLongToBeat API

An unofficial API for accessing HowLongToBeat data on games.

原始信息汇总

数据集概述：HowLongToBeat API

HowLongToBeat API 是一个非官方的 API，用于访问 HowLongToBeat（HLTB）平台的游戏元数据和用户统计数据。它提供了一系列端点，支持搜索游戏、用户和集合，获取详细的游戏记录，以及暴露全站统计信息。此外，它还包含 Steam 集合匹配功能，便于将用户的 Steam 库与 HLTB 的游戏时长和完成度数据关联。

核心功能与端点

• 搜索控制器

  • 搜索游戏 (GET /search/games/{searchText})：根据游戏标题进行搜索，支持分页、模糊/精确匹配、平台、玩法类型、发行年份、游戏时长、游戏类型、排序和随机选择等过滤条件。
  • 搜索集合 (GET /search/collections/{searchText})：搜索游戏列表/集合，支持分页、匹配模式、排序和随机选择。
  • 搜索用户 (GET /search/users/{searchText})：根据用户名搜索用户，支持分页、匹配模式、排序和随机选择。

• 游戏控制器

  • 按ID获取游戏详情 (GET /games/{gameId})：通过游戏ID获取详细数据，包括元数据、游戏时长、速通、评论和参与度统计。
  • 按名称获取游戏详情 (GET /games)：通过精确游戏名称查询并返回详细数据。

• 站点统计控制器

  • 按人气排名获取游戏 (GET /site-stats/games/popular)：获取用户提交最多的热门游戏，支持平台、发行年份、视角、流程、类型和Top-N限制过滤。
  • 按统计类别排名获取游戏 (GET /site-stats/games/{category})：获取特定统计类别（如最多游玩中、最多搁置、完成度最高、速通最多、评分最好/最差、最短/最长游戏等）的排名列表，支持多种过滤和Top-N限制。其中，stat字段在不同类别中代表不同数值（评分为0-100、时长为秒、其余为计数）。

• Steam控制器

  • 获取带HLTB数据的Steam集合 (GET /steam/collection/{profileId}/how-long-to-beat)：检索Steam用户的游戏收藏，并匹配HLTB数据，包括游戏时长统计和总完成时间。

基础信息

• 基础URL：https://howlongtobeat-api.onrender.com
• 当前版本：0.1.0
• 定价模式：Freemium，免费层后按量付费，提供订阅计划和超额计费。
• 请求限制：免费使用，每秒请求限制为1次。
• 错误处理：使用标准HTTP状态码（200、400、401、404、422、500）指示请求成功或失败。