HowLongToBeat API
An unofficial API for accessing HowLongToBeat game metadata and user stats. It provides endpoints for searching games, users, and collections, retrieving detailed game records, and exposing site-wide statistics such as popular titles and ranked category lists. It also includes Steam collection matching, making it easier to connect a user’s library with HowLongToBeat playtime and completion data…
5 subscribers
9.3/10 popularity
846 ms avg latency
100% success rate
8 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
HowLongToBeat API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Search | ||
| GET |
Search for games /search/games/{searchText} |
Search HowLongToBeat games by title and return paginated results with optional match mode, platform, gameplay, release year, playtime, game type, sorting, and random selection… |
| GET |
Search for collections /search/collections/{searchText} |
Search HowLongToBeat collections by title and return paginated results with optional match mode, sorting, and random selection. |
| GET |
Search for users /search/users/{searchText} |
Search HowLongToBeat users by name and return paginated results with optional match mode, sorting, and random selection. |
| Games | ||
| GET |
Get game details by name /games |
Look up a game by exact title and return detailed HowLongToBeat data, including metadata, playtime, speedrun, review, and engagement statistics. |
| GET |
Get game details by ID /games/{gameId} |
Get detailed HowLongToBeat data for a game by its numeric ID, including metadata, playtime, speedrun, review, and engagement statistics. |
| Site Stats | ||
| GET |
Get games ranked by popularity /site-stats/games/popular |
Retrieve a list of games ranked by popularity, with optional filters for platform, release year, gameplay perspective, flow, and genre. Results can be limited to the top N games. |
| GET |
Get games ranked by stat category /site-stats/games/{category} |
Retrieve a list of games ranked by a specific stat category, with optional filters for platform, release year, gameplay perspective, flow, and genre. The category determines… |
| Steam | ||
| GET |
Get Steam collection with HLTB data /steam/collection/{profileId}/how-long-to-beat |
Retrieve a Steam user's game collection with matching HLTB data, including playtime statistics and aggregate completion times. |
HowLongToBeat API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | Free | 1 / second |
|
| ULTRA | $5.95 / month | 2 / second |
|
| MEGA | $16.95 / month | 1 / second |
|
