Where do I get achievement percentages for any Steam game?
Call GetGlobalAchievementPercentagesForApp in the ISteamUserStats Web API. It takes one parameter, gameid, and returns the global unlock percentage for each achievement. Valve lists no key for this method, so you can read it for your own game and for any comp.
The response gives internal API names, such as CH1, and a percentage. To see the display names and descriptions, open the global achievements page of the game on Steam Community. It lists the same achievements from the most common to the rarest. GetSchemaForGame also returns names, but it needs a Web API key.
Global achievement percentages (504230 is Celeste)
https://api.steampowered.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v0002/?gameid=504230&format=jsonSources: Steamworks ISteamUserStats Web API documentation; Steamworks Stats and Achievements documentation.
Which achievements show where players quit?
Progress achievements: the ones every player unlocks on the main path, such as "complete chapter 2" or "defeat the first boss". Their percentages fall as players stop. The step between two of them is the share of players you lost in that part of the game.
Skip collection, skill and secret achievements for this reading. "Collect 175 strawberries" measures how many players chase extras, not where the main path breaks. Keep them for a second question: how many players stay after the credits.
| Type | Example | Use it for |
|---|---|---|
| Progress | Complete chapter 3 | Where players stop on the main path |
| Ending | Reach the credits | Completion rate |
| Collection | Collect 30 items | How many players explore |
| Skill or challenge | Finish without dying | The size of your hardcore group |
| Post-game | Finish the bonus chapter | How many players stay after the end |
Sources: Steamworks Stats and Achievements documentation; Steam Community global achievements pages.
What does a worked reading look like?
Here is Celeste, as read from the Web API on 18 November 2026. The chapter achievements are CH1 to CH7. Steam Community describes CH1 to CH6 as "Complete Chapter 1" to "Complete Chapter 6", and CH7 as "Climb Celeste Mountain".
The biggest loss is before the end of chapter 1: 29.3% of players never unlocked it (our arithmetic, 100 minus 70.7). After that, each chapter keeps 82% to 95% of the players who finished the one before. Chapter 3 keeps the smallest share, 82.0%. From chapter 5 on, almost everyone who gets there finishes, so the climb itself holds players well.
Read the relative step, not only the points lost. A drop of 9.0 points early and a drop of 2.1 points late can mean the same share of the players who were still there.
| Achievement | Unlocked | Kept from previous step |
|---|---|---|
| CH1, complete chapter 1 | 70.7% | Start |
| CH2, complete chapter 2 | 61.7% | 87.3% |
| CH3, complete chapter 3 | 50.6% | 82.0% |
| CH4, complete chapter 4 | 43.1% | 85.2% |
| CH5, complete chapter 5 | 38.6% | 89.6% |
| CH6, complete chapter 6 | 36.7% | 95.1% |
| CH7, climb Celeste Mountain | 34.6% | 94.3% |
Sources: Steam Web API, Celeste global achievement percentages; Steam Community, Celeste global achievements.
How do I compare my game with comps?
Pick 3 to 5 comps with a similar structure and price, read their progress achievements on the same day, and put them on one sheet. Compare three numbers: the first progress achievement, the step with the lowest kept share, and the ending.
Structure matters. Hollow Knight is open, so players meet bosses in different orders. On 18 November 2026, 71.3% had defeated the False Knight, 62.7% Hornet in Greenpath and 47.0% the Soul Master. You cannot read these as steps in a line. Use open games only for "how many reach this point at all".
Use comps for the shape, not the exact level. If your first progress achievement is far below your comps, the problem is in the first hour: install, tutorial, controls or the first fight.
- List comps from your market research sheet.
- Find each App ID and call the Web API on the same day.
- Mark the progress achievements in order for each game.
- Compute the kept share for each step.
- Compare your first step, your worst step and your ending with the comp range.
Sources: Steam Community, Hollow Knight global achievements; Steam Community, Celeste global achievements.
What are the limits of achievement data?
Valve calls the number the percentage of Steam players of the game who have the achievement. It does not say how owners who never launched the game are counted, so the first achievement can look low for reasons outside the game. The API also rounds to one decimal.
The data has no dates, no builds and no players. You cannot see when the drop happened, whether a patch fixed it, or who quit. A game also needs achievements on its main path. Valve limits a new game to 100 achievements at first, which is plenty for chapter markers.
Sources: Steamworks Stats and Achievements documentation; Steamworks ISteamUserStats Web API documentation.
How do I turn a reading into a decision?
Match the shape of your curve to a cause, then check the cause with your own events. The curve tells you where to look. It does not tell you why players left.
Hidden achievements still count. In Celeste, the chapter achievements are marked hidden on Steam Community, but the Web API returns their percentages like any other. So you can read the main path of a comp even when the store page hides the names.
| Shape | Likely cause | Check first |
|---|---|---|
| Low first step | First hour: launch, tutorial, controls | Your first session funnel |
| One deep step mid-game | A difficulty wall or a slow stretch | Fail rate and deaths in that part |
| Steady loss every step | The game is long for its audience | Session length and playtime |
| Flat late steps | Players who reach the end want to finish | Nothing to fix here |
Sources: Steam Community, Celeste global achievements; Steam Web API, Celeste global achievement percentages.
How do I see the drop-off inside my own game?
Send your own progress events. A level_start, level_complete and level_fail event per level, or a chapter_complete event per chapter, gives you the same step chart with dates, builds and players. Then you can split it by source, platform or build and test a fix.
Use achievements to compare with comps, and your own events to find and fix the cause. Add one progress achievement per chapter too, so the public number and your private number line up.
Sources: Manalens game events documentation.
Where can I see my own drop-off by build?
Manalens is the analytics and growth engine built for games. Send level_start, level_complete and level_fail from the Unity or Godot SDK. The Game KPIs dashboard shows a level funnel and a levels table with starts, completes, fails and the fail rate, and you can filter it by build.
Sources: Manalens product documentation.
Frequently asked questions
Do I need a Steam Web API key to read achievement percentages?
No. Valve lists only the gameid parameter for GetGlobalAchievementPercentagesForApp, so the call works without a key. You need a key for GetSchemaForGame, which returns names. For display names without a key, open the Steam Community global achievements page of the game.
Why is my first achievement unlocked by far fewer players than I expected?
Some owners never launch the game, and Valve does not say how it counts them. Bundles, gifts and sales add owners who may never play. So compare your first achievement with comps sold in a similar way, and check your own launch events before you change the first level.
How many achievements should mark the main path?
One per chapter, act or major boss is enough. Use the same wording for each, such as complete chapter 3, so players and you can read them in order. Put them in places every player must pass. Valve allows 100 achievements at first, so this costs little.
Can achievement data show where players quit inside a level?
No. It only shows how many players reached each achievement. To see the place inside a level, send a death or quit event with the level and position, and count the events per area. Achievement data tells you which part to look at first.
Sources and implementation
- Steamworks documentation: ISteamUserStats Web API (Valve, read 18 November 2026) ↗
- Steamworks documentation: Stats and Achievements (Valve, read 18 November 2026) ↗
- Steam Web API: global achievement percentages for Celeste, app 504230 (Valve, read 18 November 2026) ↗
- Steam Community: Celeste global achievements (Valve, read 18 November 2026) ↗
- Steam Community: Hollow Knight global achievements (Valve, read 18 November 2026) ↗