Every Steam Web API endpoint, plus a local SQLite store that turns friend playtimes, achievement progress, and library backlogs into single SQL queries no other tool can answer.
Mirrors all 169 documented Steam Web API endpoints (and the undocumented store endpoints every wrapper picks one of) with rate-limit-aware throttling for the post-2025 25 req/s budget. Adds a local SQLite layer with FTS5 over apps, news, and achievements so cross-library queries — next-achievement, friends compare, library audit, achievement-leaderboard — run as one command instead of an N+1 fanout app rewrite. Ships an MCP server with both stdio and HTTP streamable transport plus a code-orchestration pair (steam_web_search + steam_web_execute) so the full surface is reachable without flooding your agent's tool catalog.
Learn more at Steam Web.
Authentication
Standard Steam Web API key auth: get one at https://steamcommunity.com/dev/apikey and set STEAM_WEB_API_KEY in your environment. The key is sent as a ?key= query parameter on every request. Some endpoints (server time, app list, news) require no auth at all and work without a key. The IAuthenticationService endpoints in the spec are NOT for Web API auth — they implement Steam's interactive QR-code login flow. They remain reachable via the CLI subcommand and the MCP code-orchestration pair for completeness but should not be used as part of normal Web API workflows.
Quick Start
# Reports whether STEAM_WEB_API_KEY is set in your env. Steam keys are env-var only; export it from your shell rather than running auth set-token.
steam-web-pp-cli auth status
# Probes /ISteamWebAPIUtil/GetServerInfo and a key-gated read to confirm both reachability and your key's validity.
steam-web-pp-cli doctor
# Pulls profile, owned games, friend list, and recent achievements into the local SQLite store; the cross-library novel features all read from this store.
steam-web-pp-cli sync
# Once sync completes, this is the achievement-hunter's daily ritual — five lowest-effort unlocks across your whole library.
steam-web-pp-cli next-achievement --steamid 76561197960287930 --limit 5
# Throttled fan-out across your friend list to rank everyone by hours in app 1245620 (Elden Ring); each call also caches per-friend GetOwnedGames responses to local SQLite for next time.
steam-web-pp-cli friends compare 1245620 --my-steamid 76561197960287930
Unique Features
These capabilities aren't available in any other tool for this API.
Local state that compounds
-
library audit — Surface never-launched games, paid titles you bounced off in under 2 hours, and where your hours actually went by genre.
Use this when an agent is asked to plan what to play next, justify a refund, or summarize the user's gaming spend.
steam-web-pp-cli library audit 76561197960287930 --bounce --json
-
review-velocity — Reviews per day and voted-up share over a rolling window for one app — date-bucket aggregation over the cursor-paginated appreviews stream.
Use this when an agent is asked to track sentiment shifts after a patch, sale, or controversy.
steam-web-pp-cli review-velocity 1245620 --window 30d --json
-
news search — FTS5 search across the title and contents of every news post you've synced, optionally scoped by appid or date range.
Use this when an agent is asked to dig up patch notes, devlog mentions, or news around a specific topic across the user's library.
steam-web-pp-cli news search 'patch notes' --since 2026-04-01 --json
-
play-trend — Show concurrent-player count over time for one app as a sparkline plus min/max/last over a rolling window — value scales with how often you sample.
Use this when an agent needs to see whether a game's playerbase is growing, falling, or has spiked around an event — sample the count every few hours via cron and the window query becomes meaningful within a week.
steam-web-pp-cli play-trend 1245620 --window 7d --json
Friend-graph intelligence
-
friends compare — Rank everyone in your friend list by hours spent in a specific game, with throttled fan-out so you don't trip Steam's 25 req/s budget.
Use this when an agent is asked 'who in my friends has the most hours in ' or 'who owns this and never played'.
steam-web-pp-cli friends compare 1245620 --my-steamid 76561197960287930 --agent --select results.persona_name,results.playtime_hours
-
library compare — Set operations across two libraries — what's mine-only, what's theirs-only, what's shared with playtime delta.
Use this when an agent is asked 'what games do my friend and I both own' or to plan a co-op session.
steam-web-pp-cli library compare 76561197960287930 --my-steamid 76561197960287930 --shared --json
-
currently-playing — Show which friends are in-game right now and what they're playing — one batched API call across the friend list, no fanout.
Use this when an agent is asked 'who is online and playing what' or to power a status panel.
steam-web-pp-cli currently-playing --my-steamid 76561197960287930 --json
-
achievement-leaderboard — Rank your friends by achievement completion percentage for one app, throttled fan-out via the same limiter that powers friends compare.
Use this when an agent is asked 'who in my friends is closest to 100% in ' or to seed a competitive completion challenge.
steam-web-pp-cli achievement-leaderboard 1245620 --my-steamid 76561197960287930 --json
Achievement intelligence
-
next-achievement — Across your entire library, surface the achievement with the highest global unlock percentage that you still don't have.
Use this when an agent is asked 'what should I go unlock next' or to recommend low-effort achievement progress for completionists.
steam-web-pp-cli next-achievement --steamid 76561197960287930 --limit 10 --json
-
achievement-hunt — Render the full achievement schema for one app side-by-side with your unlock state and the global rarity of each achievement in one table.
Use this when an agent needs the full unlock landscape for one game to plan a completion run.
steam-web-pp-cli achievement-hunt 1245620 --steamid 76561197960287930 --locked --json
-
rare-achievements — Surface your rarest achievement unlocks across all owned games — the inverse of the next-achievement query, sorted by ascending global percentage.
Use this when an agent is asked to summarize what the user is proud of, or to power a profile-flex panel.
steam-web-pp-cli rare-achievements --steamid 76561197960287930 --limit 10 --json
Usage
Run steam-web-pp-cli --help for the full command reference and flag list.
Commands
iauthentication-service
Manage iauthentication service
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials - BeginAuthSessionViaCredentials operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service begin-auth-session-via-qr - BeginAuthSessionViaQR operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service get-auth-session-info - GetAuthSessionInfo operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service get-auth-session-risk-info - GetAuthSessionRiskInfo operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service get-password-rsapublic-key - GetPasswordRSAPublicKey operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service notify-risk-quiz-results - NotifyRiskQuizResults operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service poll-auth-session-status - PollAuthSessionStatus operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service update-auth-session-with-mobile-confirmation - UpdateAuthSessionWithMobileConfirmation operation of IAuthenticationServicesteam-web-pp-cli iauthentication-service update-auth-session-with-steam-guard-code - UpdateAuthSessionWithSteamGuardCode operation of IAuthenticationService
ibroadcast-service
Manage ibroadcast service
steam-web-pp-cli ibroadcast-service post-game-data-frame-rtmp - PostGameDataFrameRTMP operation of IBroadcastService
icheat-reporting-service
Manage icheat reporting service
steam-web-pp-cli icheat-reporting-service report-cheat-data - ReportCheatData operation of ICheatReportingService
iclient-stats-1046930
Manage iclient stats 1046930
steam-web-pp-cli iclient-stats-1046930 report-event - ReportEvent operation of IClientStats_1046930
icontent-server-config-service
Manage icontent server config service
steam-web-pp-cli icontent-server-config-service get-steam-cache-node-params - GetSteamCacheNodeParams operation of IContentServerConfigServicesteam-web-pp-cli icontent-server-config-service set-steam-cache-client-filters - SetSteamCacheClientFilters operation of IContentServerConfigServicesteam-web-pp-cli icontent-server-config-service set-steam-cache-performance-stats - SetSteamCachePerformanceStats operation of IContentServerConfigService
icontent-server-directory-service
Manage icontent server directory service
steam-web-pp-cli icontent-server-directory-service get-cdnfor-video - GetCDNForVideo operation of IContentServerDirectoryServicesteam-web-pp-cli icontent-server-directory-service get-client-update-hosts - GetClientUpdateHosts operation of IContentServerDirectoryServicesteam-web-pp-cli icontent-server-directory-service get-depot-patch-info - GetDepotPatchInfo operation of IContentServerDirectoryServicesteam-web-pp-cli icontent-server-directory-service get-servers-for-steam-pipe - GetServersForSteamPipe operation of IContentServerDirectoryServicesteam-web-pp-cli icontent-server-directory-service pick-single-content-server - PickSingleContentServer operation of IContentServerDirectoryService
icsgoplayers-730
Manage icsgoplayers 730
steam-web-pp-cli icsgoplayers-730 get-next-match-sharing-code - GetNextMatchSharingCode operation of ICSGOPlayers_730
icsgoservers-730
Manage icsgoservers 730
steam-web-pp-cli icsgoservers-730 get-game-maps-playtime - GetGameMapsPlaytime operation of ICSGOServers_730steam-web-pp-cli icsgoservers-730 get-game-servers-status - GetGameServersStatus operation of ICSGOServers_730
icsgotournaments-730
Manage icsgotournaments 730
steam-web-pp-cli icsgotournaments-730 get-tournament-fantasy-lineup - GetTournamentFantasyLineup operation of ICSGOTournaments_730steam-web-pp-cli icsgotournaments-730 get-tournament-items - GetTournamentItems operation of ICSGOTournaments_730steam-web-pp-cli icsgotournaments-730 get-tournament-layout - GetTournamentLayout operation of ICSGOTournaments_730steam-web-pp-cli icsgotournaments-730 get-tournament-predictions - GetTournamentPredictions operation of ICSGOTournaments_730steam-web-pp-cli icsgotournaments-730 upload-tournament-fantasy-lineup - UploadTournamentFantasyLineup operation of ICSGOTournaments_730steam-web-pp-cli icsgotournaments-730 upload-tournament-predictions - UploadTournamentPredictions operation of ICSGOTournaments_730
idota2-match-570
Manage idota2 match 570
steam-web-pp-cli idota2-match-570 get-live-league-games - GetLiveLeagueGames operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-match-details - GetMatchDetails operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-match-history - GetMatchHistory operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-match-history-by-sequence-num - GetMatchHistoryBySequenceNum operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-team-info-by-team-id - GetTeamInfoByTeamID operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-top-live-event-game - GetTopLiveEventGame operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-top-live-game - GetTopLiveGame operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-top-weekend-tourney-games - GetTopWeekendTourneyGames operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-tournament-player-stats - GetTournamentPlayerStats operation of IDOTA2Match_570steam-web-pp-cli idota2-match-570 get-tournament-player-stats-idota2match570 - GetTournamentPlayerStats operation of IDOTA2Match_570
idota2-match-stats-570
Manage idota2 match stats 570
steam-web-pp-cli idota2-match-stats-570 get-realtime-stats - GetRealtimeStats operation of IDOTA2MatchStats_570
idota2-stream-system-570
Manage idota2 stream system 570
steam-web-pp-cli idota2-stream-system-570 get-broadcaster-info - GetBroadcasterInfo operation of IDOTA2StreamSystem_570
idota2-ticket-570
Manage idota2 ticket 570
steam-web-pp-cli idota2-ticket-570 get-steam-idfor-badge-id - GetSteamIDForBadgeID operation of IDOTA2Ticket_570steam-web-pp-cli idota2-ticket-570 set-steam-account-purchased - SetSteamAccountPurchased operation of IDOTA2Ticket_570steam-web-pp-cli idota2-ticket-570 steam-account-valid-for-badge-type - SteamAccountValidForBadgeType operation of IDOTA2Ticket_570
iecon-dota2-570
Manage iecon dota2 570
steam-web-pp-cli iecon-dota2-570 get-event-stats-for-account - GetEventStatsForAccount operation of IEconDOTA2_570steam-web-pp-cli iecon-dota2-570 get-heroes - GetHeroes operation of IEconDOTA2_570steam-web-pp-cli iecon-dota2-570 get-item-creators - GetItemCreators operation of IEconDOTA2_570steam-web-pp-cli iecon-dota2-570 get-item-workshop-published-file-ids - GetItemWorkshopPublishedFileIDs operation of IEconDOTA2_570steam-web-pp-cli iecon-dota2-570 get-rarities - GetRarities operation of IEconDOTA2_570steam-web-pp-cli iecon-dota2-570 get-tournament-prize-pool - GetTournamentPrizePool operation of IEconDOTA2_570
iecon-items-1046930
Manage iecon items 1046930
steam-web-pp-cli iecon-items-1046930 get-player-items - GetPlayerItems operation of IEconItems_1046930
iecon-items-1269260
Manage iecon items 1269260
steam-web-pp-cli iecon-items-1269260 get-equipped-player-items - GetEquippedPlayerItems operation of IEconItems_1269260
iecon-items-440
Manage iecon items 440
steam-web-pp-cli iecon-items-440 get-player-items - GetPlayerItems operation of IEconItems_440steam-web-pp-cli iecon-items-440 get-schema - GetSchema operation of IEconItems_440steam-web-pp-cli iecon-items-440 get-schema-items - GetSchemaItems operation of IEconItems_440steam-web-pp-cli iecon-items-440 get-schema-overview - GetSchemaOverview operation of IEconItems_440steam-web-pp-cli iecon-items-440 get-schema-url - GetSchemaURL operation of IEconItems_440steam-web-pp-cli iecon-items-440 get-store-meta-data - GetStoreMetaData operation of IEconItems_440steam-web-pp-cli iecon-items-440 get-store-status - GetStoreStatus operation of IEconItems_440
iecon-items-570
Manage iecon items 570
steam-web-pp-cli iecon-items-570 get-player-items - GetPlayerItems operation of IEconItems_570steam-web-pp-cli iecon-items-570 get-store-meta-data - GetStoreMetaData operation of IEconItems_570
iecon-items-583950
Manage iecon items 583950
steam-web-pp-cli iecon-items-583950 get-equipped-player-items - GetEquippedPlayerItems operation of IEconItems_583950
iecon-items-620
Manage iecon items 620
steam-web-pp-cli iecon-items-620 get-player-items - GetPlayerItems operation of IEconItems_620steam-web-pp-cli iecon-items-620 get-schema - GetSchema operation of IEconItems_620
iecon-items-730
Manage iecon items 730
steam-web-pp-cli iecon-items-730 get-player-items - GetPlayerItems operation of IEconItems_730steam-web-pp-cli iecon-items-730 get-schema - GetSchema operation of IEconItems_730steam-web-pp-cli iecon-items-730 get-schema-url - GetSchemaURL operation of IEconItems_730steam-web-pp-cli iecon-items-730 get-store-meta-data - GetStoreMetaData operation of IEconItems_730
iecon-service
Manage iecon service
steam-web-pp-cli iecon-service get-trade-history - GetTradeHistory operation of IEconServicesteam-web-pp-cli iecon-service get-trade-hold-durations - GetTradeHoldDurations operation of IEconServicesteam-web-pp-cli iecon-service get-trade-offer - GetTradeOffer operation of IEconServicesteam-web-pp-cli iecon-service get-trade-offers - GetTradeOffers operation of IEconServicesteam-web-pp-cli iecon-service get-trade-offers-summary - GetTradeOffersSummary operation of IEconServicesteam-web-pp-cli iecon-service get-trade-status - GetTradeStatus operation of IEconService
igame-notifications-service
Manage igame notifications service
steam-web-pp-cli igame-notifications-service user-create-session - UserCreateSession operation of IGameNotificationsServicesteam-web-pp-cli igame-notifications-service user-delete-session - UserDeleteSession operation of IGameNotificationsServicesteam-web-pp-cli igame-notifications-service user-update-session - UserUpdateSession operation of IGameNotificationsService
igame-servers-service
Manage igame servers service
steam-web-pp-cli igame-servers-service create-account - CreateAccount operation of IGameServersServicesteam-web-pp-cli igame-servers-service delete-account - DeleteAccount operation of IGameServersServicesteam-web-pp-cli igame-servers-service get-account-list - GetAccountList operation of IGameServersServicesteam-web-pp-cli igame-servers-service get-account-public-info - GetAccountPublicInfo operation of IGameServersServicesteam-web-pp-cli igame-servers-service get-server-ips-by-steam-id - GetServerIPsBySteamID operation of IGameServersServicesteam-web-pp-cli igame-servers-service get-server-steam-ids-by-ip - GetServerSteamIDsByIP operation of IGameServersServicesteam-web-pp-cli igame-servers-service query-by-fake-ip - QueryByFakeIP operation of IGameServersServicesteam-web-pp-cli igame-servers-service query-login-token - QueryLoginToken operation of IGameServersServicesteam-web-pp-cli igame-servers-service reset-login-token - ResetLoginToken operation of IGameServersServicesteam-web-pp-cli igame-servers-service set-memo - SetMemo operation of IGameServersService
igcversion-1046930
Manage igcversion 1046930
steam-web-pp-cli igcversion-1046930 get-client-version - GetClientVersion operation of IGCVersion_1046930steam-web-pp-cli igcversion-1046930 get-server-version - GetServerVersion operation of IGCVersion_1046930
igcversion-1269260
Manage igcversion 1269260
steam-web-pp-cli igcversion-1269260 get-client-version - GetClientVersion operation of IGCVersion_1269260steam-web-pp-cli igcversion-1269260 get-server-version - GetServerVersion operation of IGCVersion_1269260
igcversion-1422450
Manage igcversion 1422450
steam-web-pp-cli igcversion-1422450 get-client-version - GetClientVersion operation of IGCVersion_1422450steam-web-pp-cli igcversion-1422450 get-server-version - GetServerVersion operation of IGCVersion_1422450
igcversion-440
Manage igcversion 440
steam-web-pp-cli igcversion-440 get-client-version - GetClientVersion operation of IGCVersion_440steam-web-pp-cli igcversion-440 get-server-version - GetServerVersion operation of IGCVersion_440
igcversion-570
Manage igcversion 570
steam-web-pp-cli igcversion-570 get-client-version - GetClientVersion operation of IGCVersion_570steam-web-pp-cli igcversion-570 get-server-version - GetServerVersion operation of IGCVersion_570
igcversion-583950
Manage igcversion 583950
steam-web-pp-cli igcversion-583950 get-client-version - GetClientVersion operation of IGCVersion_583950steam-web-pp-cli igcversion-583950 get-server-version - GetServerVersion operation of IGCVersion_583950
igcversion-730
Manage igcversion 730
steam-web-pp-cli igcversion-730 get-server-version - GetServerVersion operation of IGCVersion_730
ihelp-request-logs-service
Manage ihelp request logs service
steam-web-pp-cli ihelp-request-logs-service get-application-log-demand - GetApplicationLogDemand operation of IHelpRequestLogsServicesteam-web-pp-cli ihelp-request-logs-service upload-user-application-log - UploadUserApplicationLog operation of IHelpRequestLogsService
iinventory-service
Manage iinventory service
steam-web-pp-cli iinventory-service combine-item-stacks - CombineItemStacks operation of IInventoryServicesteam-web-pp-cli iinventory-service get-price-sheet - GetPriceSheet operation of IInventoryServicesteam-web-pp-cli iinventory-service split-item-stack - SplitItemStack operation of IInventoryService
iplayer-service
Manage iplayer service
steam-web-pp-cli iplayer-service get-badges - GetBadges operation of IPlayerServicesteam-web-pp-cli iplayer-service get-community-badge-progress - GetCommunityBadgeProgress operation of IPlayerServicesteam-web-pp-cli iplayer-service get-owned-games - GetOwnedGames operation of IPlayerServicesteam-web-pp-cli iplayer-service get-recently-played-games - GetRecentlyPlayedGames operation of IPlayerServicesteam-web-pp-cli iplayer-service get-steam-level - GetSteamLevel operation of IPlayerServicesteam-web-pp-cli iplayer-service is-playing-shared-game - IsPlayingSharedGame operation of IPlayerServicesteam-web-pp-cli iplayer-service record-offline-playtime - RecordOfflinePlaytime operation of IPlayerService
iportal2-leaderboards-620
Manage iportal2 leaderboards 620
steam-web-pp-cli iportal2-leaderboards-620 get-bucketized-data - GetBucketizedData operation of IPortal2Leaderboards_620
ipublished-file-service
Manage ipublished file service
steam-web-pp-cli ipublished-file-service get-details - GetDetails operation of IPublishedFileServicesteam-web-pp-cli ipublished-file-service get-sub-section-data - GetSubSectionData operation of IPublishedFileServicesteam-web-pp-cli ipublished-file-service get-user-file-count - GetUserFileCount operation of IPublishedFileServicesteam-web-pp-cli ipublished-file-service get-user-files - GetUserFiles operation of IPublishedFileServicesteam-web-pp-cli ipublished-file-service get-user-vote-summary - GetUserVoteSummary operation of IPublishedFileServicesteam-web-pp-cli ipublished-file-service query-files - QueryFiles operation of IPublishedFileService
isteam-apps
Manage isteam apps
steam-web-pp-cli isteam-apps get-sdrconfig - GetSDRConfig operation of ISteamAppssteam-web-pp-cli isteam-apps get-servers-at-address - GetServersAtAddress operation of ISteamAppssteam-web-pp-cli isteam-apps up-to-date-check - UpToDateCheck operation of ISteamApps
isteam-broadcast
Manage isteam broadcast
steam-web-pp-cli isteam-broadcast player-stats - PlayerStats operation of ISteamBroadcaststeam-web-pp-cli isteam-broadcast viewer-heartbeat - ViewerHeartbeat operation of ISteamBroadcast
isteam-cdn
Manage isteam cdn
steam-web-pp-cli isteam-cdn set-client-filters - SetClientFilters operation of ISteamCDNsteam-web-pp-cli isteam-cdn set-performance-stats - SetPerformanceStats operation of ISteamCDN
isteam-directory
Manage isteam directory
steam-web-pp-cli isteam-directory get-cmlist - GetCMList operation of ISteamDirectorysteam-web-pp-cli isteam-directory get-cmlist-for-connect - GetCMListForConnect operation of ISteamDirectorysteam-web-pp-cli isteam-directory get-steam-pipe-domains - GetSteamPipeDomains operation of ISteamDirectory
isteam-economy
Manage isteam economy
steam-web-pp-cli isteam-economy get-asset-class-info - GetAssetClassInfo operation of ISteamEconomysteam-web-pp-cli isteam-economy get-asset-prices - GetAssetPrices operation of ISteamEconomy
isteam-news
Manage isteam news
steam-web-pp-cli isteam-news get-news-for-app - GetNewsForApp operation of ISteamNewssteam-web-pp-cli isteam-news get-news-for-app-isteamnews - GetNewsForApp operation of ISteamNews
isteam-remote-storage
Manage isteam remote storage
steam-web-pp-cli isteam-remote-storage get-collection-details - GetCollectionDetails operation of ISteamRemoteStoragesteam-web-pp-cli isteam-remote-storage get-published-file-details - GetPublishedFileDetails operation of ISteamRemoteStoragesteam-web-pp-cli isteam-remote-storage get-ugcfile-details - GetUGCFileDetails operation of ISteamRemoteStorage
isteam-user
Manage isteam user
steam-web-pp-cli isteam-user get-friend-list - GetFriendList operation of ISteamUsersteam-web-pp-cli isteam-user get-player-bans - GetPlayerBans operation of ISteamUsersteam-web-pp-cli isteam-user get-player-summaries - GetPlayerSummaries operation of ISteamUsersteam-web-pp-cli isteam-user get-player-summaries-isteamuser - GetPlayerSummaries operation of ISteamUsersteam-web-pp-cli isteam-user get-user-group-list - GetUserGroupList operation of ISteamUsersteam-web-pp-cli isteam-user resolve-vanity-url - ResolveVanityURL operation of ISteamUser
isteam-user-auth
Manage isteam user auth
steam-web-pp-cli isteam-user-auth authenticate-user-ticket - AuthenticateUserTicket operation of ISteamUserAuth
isteam-user-oauth
Manage isteam user oauth
steam-web-pp-cli isteam-user-oauth get-token-details - GetTokenDetails operation of ISteamUserOAuth
isteam-user-stats
Manage isteam user stats
steam-web-pp-cli isteam-user-stats get-global-achievement-percentages-for-app - GetGlobalAchievementPercentagesForApp operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-global-achievement-percentages-for-app-isteamuserstats - GetGlobalAchievementPercentagesForApp operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-global-stats-for-game - GetGlobalStatsForGame operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-number-of-current-players - GetNumberOfCurrentPlayers operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-player-achievements - GetPlayerAchievements operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-schema-for-game - GetSchemaForGame operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-schema-for-game-isteamuserstats - GetSchemaForGame operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-user-stats-for-game - GetUserStatsForGame operation of ISteamUserStatssteam-web-pp-cli isteam-user-stats get-user-stats-for-game-isteamuserstats - GetUserStatsForGame operation of ISteamUserStats
isteam-web-apiutil
Manage isteam web apiutil
steam-web-pp-cli isteam-web-apiutil get-server-info - GetServerInfo operation of ISteamWebAPIUtilsteam-web-pp-cli isteam-web-apiutil get-supported-apilist - GetSupportedAPIList operation of ISteamWebAPIUtil
istore-service
Manage istore service
steam-web-pp-cli istore-service get-app-list - Gets a list of all apps available on the Steam Storesteam-web-pp-cli istore-service get-games-followed - GetGamesFollowed operation of IStoreServicesteam-web-pp-cli istore-service get-games-followed-count - GetGamesFollowedCount operation of IStoreServicesteam-web-pp-cli istore-service get-recommended-tags-for-user - GetRecommendedTagsForUser operation of IStoreService
itfitems-440
Manage itfitems 440
steam-web-pp-cli itfitems-440 get-golden-wrenches - GetGoldenWrenches operation of ITFItems_440steam-web-pp-cli itfitems-440 get-golden-wrenches-itfitems440 - GetGoldenWrenches operation of ITFItems_440
itfpromos-440
Manage itfpromos 440
steam-web-pp-cli itfpromos-440 get-item-id - GetItemID operation of ITFPromos_440steam-web-pp-cli itfpromos-440 grant-item - GrantItem operation of ITFPromos_440
itfpromos-620
Manage itfpromos 620
steam-web-pp-cli itfpromos-620 get-item-id - GetItemID operation of ITFPromos_620steam-web-pp-cli itfpromos-620 grant-item - GrantItem operation of ITFPromos_620
itfsystem-440
Manage itfsystem 440
steam-web-pp-cli itfsystem-440 get-world-status - GetWorldStatus operation of ITFSystem_440
iwishlist-service
Manage iwishlist service
steam-web-pp-cli iwishlist-service get-wishlist - GetWishlist operation of IWishlistServicesteam-web-pp-cli iwishlist-service get-wishlist-item-count - GetWishlistItemCount operation of IWishlistServicesteam-web-pp-cli iwishlist-service get-wishlist-sorted-filtered - GetWishlistSortedFiltered operation of IWishlistService
Output Formats
# Human-readable table (default in terminal, JSON when piped)
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource
# JSON for scripting and agents
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --json
# Filter to specific fields
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --json --select id,name,status
# Dry run — show the request without sending
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --dry-run
# Agent mode — JSON + compact + no prompts in one flag
steam-web-pp-cli iauthentication-service begin-auth-session-via-credentials --account-name example-resource --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Explicit retries - add
--idempotent to create retries when a no-op success is acceptable
- Confirmable -
--yes for explicit confirmation of destructive actions
- Piped input - write commands can accept structured input when their help lists
--stdin
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.
Health Check
steam-web-pp-cli doctor
Verifies configuration, credentials, and connectivity to the API.
Configuration
Config file: ~/.config/steam-web-pp-cli/config.toml
Environment variables:
| Name | Kind | Required | Description |
|---|
STEAM_WEB_API_KEY | per_call | Yes | Set to your API credential. |
Troubleshooting
Authentication errors (exit code 4)
- Run
steam-web-pp-cli doctor to check credentials
- Verify the environment variable is set:
echo $STEAM_WEB_API_KEY
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
API-specific
- GetOwnedGames returns an empty array even though you own games — Your Steam profile (or game library) is set to private. Visit https://steamcommunity.com/my/edit/settings, set both 'My profile' and 'Game details' to Public, wait 30s, then retry. Steam returns 200 + empty payload for private profiles instead of a clear error.
- HTTP 429 with x-eresult: 25 or x-eresult: 84 — Steam tightened rate limits to ~25 req/s in mid-2025. The CLI throttles automatically via cliutil.AdaptiveLimiter, but if you're scripting outside the CLI, slow down. Wait the value of Retry-After (or 60s if absent), then retry.
- store appdetails returns null for an appid — Some appids (films, hardware, region-locked) have no store entry. Confirm the appid via
steam-web-pp-cli apps search '<name>' and try again with the canonical appid.
- GetUserStatsForGame returns empty for a game you just played — Steam takes hours-to-days to populate per-user stats for newly-purchased games. Try GetPlayerAchievements instead (achievements populate faster than stats), or wait 24h.
- vanity URL doesn't resolve — ResolveVanityURL only finds custom URLs (like /id/foo). For numeric profile URLs (/profiles/76561...), the SteamID is already in the URL — no resolve needed. Use
steam-web-pp-cli ISteamUser ResolveVanityURL --vanityurl foo.
Sources & Inspiration
This CLI was built by studying these projects and resources:
Generated by CLI Printing Press