HowLongToBeat
Game completion times, game release years and game platforms
Community-reported video game play times and completion estimates.
Your information
Game name, HowLongToBeat game link or game ID, for example Elden Ring.
More options
Platform to use for play times when listed, for example PlayStation 5. Defaults to all platforms.
Example results
Elden Ring

- Release year
- 2,022
- Player submissions
- 21,526
Platforms
- Nintendo Switch 2
- PC
- PlayStation 4
- PlayStation 5
- Xbox One
- Xbox Series X/S
About the HowLongToBeat tool
Get game length returns HowLongToBeat play times, release year, platforms, cover, and submissions from a game name, link, or ID.
An optional platform selects platform-specific play times when listed; otherwise, times cover all platforms.
Built from howlongtobeat.com. Last checked Sep 30, 2026.
Actions
Get game length
1 creditFind a game’s play times, release year, platforms, cover and player submissions by name or HowLongToBeat link or ID. When a platform has its own reported times, those replace the overall category times; platform-specific all-play-styles times are not shown.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Gamegame | Text | Required | Game name, HowLongToBeat game link or game ID, for example Elden Ring.Example: Elden Ring |
Platformplatform | Text | Optional | Platform to use for play times when listed, for example PlayStation 5. Defaults to all platforms.Example: PlayStation 5 |
What you get
| Field | Type | Description |
|---|---|---|
Namename | Text | Game title.Example: Elden Ring |
Game IDgame_id | Number | HowLongToBeat game ID.Example: 68151 |
Platformsplatforms | List | Platforms listed for the game. |
Release Yearrelease_year | Number | Year the game was released.Example: 2022 |
Cover Image URLcover_image_url | Text | Game cover image link.Example: https://howlongtobeat.com/games/68151_Elden_Ring.jpg |
Main Story Hoursmain_story_hours | Number | Main story hours.Example: 60.1 |
Howlongtobeat URLhowlongtobeat_url | Text | Game page link.Example: https://howlongtobeat.com/game/68151 |
Main Story (minutes)main_story_minutes | Number | Main story minutes.Example: 3606.2 |
Player Submissionsplayer_submissions | Number | Number of reported player completions for the selected platform when available, otherwise overall.Example: 21526 |
Completionist Hourscompletionist_hours | Number | Completionist hours.Example: 136.2 |
All Play Styles Hoursall_play_styles_hours | Number | All play styles hours; unavailable for individual platforms.Example: 105.6 |
Completionist (minutes)completionist_minutes | Number | Completionist minutes.Example: 8172.7 |
All Play Styles (minutes)all_play_styles_minutes | Number | All play styles minutes.Example: 6334.8 |
Main Story Plus Extras Hoursmain_story_plus_extras_hours | Number | Main story and extras hours.Example: 101.3 |
Main Story Plus Extras (minutes)main_story_plus_extras_minutes | Number | Main story plus extras minutes.Example: 6078.1 |
Example result
For Game: Elden Ring
{
"name": "Elden Ring",
"game_id": 68151,
"platforms": [
"Nintendo Switch 2",
"PC",
"PlayStation 4"
],
"release_year": 2022,
"cover_image_url": "https://howlongtobeat.com/games/68151_Elden_Ring.jpg",
"main_story_hours": 60.1,
"howlongtobeat_url": "https://howlongtobeat.com/game/68151",
"main_story_minutes": 3606.2,
"player_submissions": 21526,
"completionist_hours": 136.2,
"all_play_styles_hours": 105.6,
"completionist_minutes": 8172.7,
"all_play_styles_minutes": 6334.8,
"main_story_plus_extras_hours": 101.3,
"main_story_plus_extras_minutes": 6078.1
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@howlongtobeat",
"visibility": "public",
"operation": "get_game_length",
"version": 1,
"input": {
"game": "Elden Ring"
},
"response": {
"format": "json"
}
}'What you can do with it
- Compare main story and completionist times before choosing a game.
- Estimate play time with story extras.
- Check a game's release year and listed platforms.
- Review player submission counts for a selected platform.
Questions about HowLongToBeat
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this HowLongToBeat tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a HowLongToBeat account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from howlongtobeat.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 30, 2026.
How long does it take to finish a game?
Get game length returns main story, main story plus extras, and completionist play times in hours and minutes.
How long does a game take across all play styles?
Get game length returns all-play-styles times when available; this category is unavailable for individual platforms.
What platforms and release year are listed for a game?
Get game length returns the listed platforms and release year.