Usage Store and Discovery

Store & discovery

Part of the Usage reference. · ← Previous: Library · Next: Collections →

Browse the Steam store from the terminal: prices across regions, search, deals, similar games, player counts, store events, news and user reviews. These commands were added in v0.1.37-2 (price) and v0.1.38 (the rest).

Most of them go over the Steam CM connection (StoreBrowse / StoreQuery) and need an active session. news and reviews have no CM equivalent, so they read Steam's public web endpoints and work without a login. Their --help text says "storefront web; no CM equivalent".

Region and language

Every command that shows prices takes -c, --country <CC> (alias --cc), a two-letter ISO code such as US, DE or JP. When it is omitted, Aurelia uses, in order:

1. the config country setting,
2. the region of the system locale (LC_ALL, LC_MESSAGES, LC_MONETARY, then LANG),
3. US.

An invalid code fails with "type": "invalid_input". Names and store text follow -l, --lang <LANG> (alias --language), then config language, then the system locale, then english.

Listing tables

search, deals and similar print the same table: APPID, PRICE, DISCOUNT, ENDS (discount end date) and NAME, with the app type in brackets for anything that is not a game (e.g. [DLC]). Their --json rows are { "app_id", "name", "type", "is_free", "price", "price_cents", "original_price", "discount_pct", "discount_end_date", "release_date", "platforms", "reviews", "country" }.

price

Show a game's price, optionally across several regions. Requires a session.

aurelia price <APP_ID> [-r <CC,CC,...>] [-c <CC>] [-l <LANG>] [--json]

Option	Description
-r, --compare <CC,...>	Country codes to compare, comma-separated (repeatable). Duplicates are dropped.
-c, --country <CC>	Country for a single-region lookup. Ignored when --compare is given.
-l, --lang <LANG>	Language for the game's name.

One row per region shows the price, discount, original price and the date the discount ends. A region where the game is not sold reads not sold in this region, and a region whose lookup failed shows the error instead of failing the whole command. When the game is sold in more than one package or bundle, a Purchase options block follows for the first priced region, with each option's kind, name, price, discount, bundle discount and item count. The --json output is { "app_id", "name", "regions": [ { "country", "available", "is_free", "price", "price_cents", "original_price", "original_price_cents", "discount_pct", "discount_end", "discount_end_date", "purchase_options", "error" } ] }.

aurelia price 690830                    # your region
aurelia price 690830 --country JP
aurelia price 690830 --compare US,DE,JP,BR

search

Find app ids by title. Requires a session.

aurelia search <TERM> [-n <N>] [-c <CC>] [-l <LANG>] [--json]

Option	Description
-n, --count <N>	Maximum results (default 20).

With no results, search prints Steam's spelling suggestions, if it has any. The --json output is { "term", "total", "suggestions", "results": [ <row> ] }.

aurelia search "no man's sky"
aurelia search portal -n 5 --json

deals

Discounted and top-selling games in a region. Requires a session.

aurelia deals [-s <SCOPE>] [-m <PCT>] [-n <N>] [-o <START>] [-c <CC>] [-l <LANG>] [--json]

Option	Description
-s, --scope <SCOPE>	discounted-top-sellers (default): discounted items among the region's top sellers. top-sellers: top sellers, discounted or not. specials: anything discounted by at least --min-discount.
-m, --min-discount <PCT>	Minimum discount percent for specials (default 1).
-n, --count <N>	Maximum results (default 20).
-o, --start <N>	Result offset, for paging (default 0).

The header line shows the scope, the region and the total number of matches. The --json output is { "country", "scope", "start", "total", "results": [ <row> ] }.

aurelia deals
aurelia deals --scope specials --min-discount 75
aurelia deals -n 20 -o 20                 # the next page

similar

Games Steam considers similar to a given app. Requires a session.

aurelia similar <APP_ID> [-n <N>] [-c <CC>] [-l <LANG>] [--json]

Option	Description
-n, --count <N>	Maximum results (default 10).

The --json output is { "app_id", "results": [ <row> ] }.

aurelia similar 275850

players

Current number of players in-game for an app. Requires a session.

aurelia players <APP_ID> [--json]

Prints <N> players in-game (app <APP_ID>). The --json output is { "app_id", "players" }.

aurelia players 730

events

Store-wide sales and events currently running in a region. Requires a session.

aurelia events [-c <CC>] [--json]

The table shows TYPE (e.g. WeekendDeal), START, END and TITLE, with the associated app or publisher in brackets. The --json output is { "country", "events": [ { "gid", "title", "kind", "start", "end", "associated_id", "associated_name", "countries_allowed", "countries_denied" } ] }.

aurelia events
aurelia events --country DE

news

Recent news posts and announcements for an app. No login required (Steam's public ISteamNews web API).

aurelia news <APP_ID> [-n <N>] [-m <CHARS>] [--json]

Option	Description
-n, --count <N>	Maximum items (default 10).
-m, --max-length <CHARS>	Characters of body text to keep per item (default 300).

Each item prints its date, title and feed, the URL, and the shortened body. The --json output is { "app_id", "news": [ { "gid", "title", "url", "author", "feed", "date", "contents" } ] }.

aurelia news 275850
aurelia news 275850 -n 3 -m 0           # titles and links only

reviews

One page of user reviews for an app. No login required (the storefront's public appreviews endpoint).

aurelia reviews <APP_ID> [-f <FILTER>] [-t <TYPE>] [-p <PURCHASE>] [-n <N>] [-u <CURSOR>] [-l <LANG>] [--json]

Option	Description
-f, --filter <FILTER>	recent (default), updated, or all (score-weighted, "most helpful").
-t, --type <TYPE>	all (default), positive or negative.
-p, --purchase <PURCHASE>	all (default), steam or non_steam_purchase.
-n, --count <N>	Reviews per page, up to 100 (default 10).
-u, --cursor <CURSOR>	Cursor from the previous page, to fetch the next one.
-l, --lang <LANG>	Review language, or all. Defaults to your configured or locale language.

Each review shows 👍 or 👎, its date, the author, hours played, how many people found it helpful, and up to six lines of text. The overall summary line (label, percent positive, totals) appears only when Steam includes totals, which it does for --filter all. The last line prints the --cursor value for the next page. The --json output is { "app_id", "summary": { "score", "label", "total_positive", "total_negative", "total_reviews" }, "reviews": [ { "id", "author", "steam_id", "language", "voted_up", "votes_up", "votes_funny", "playtime_hours", "playtime_at_review_hours", "created", "steam_purchase", "received_for_free", "early_access", "text" } ], "next_cursor" }.

aurelia reviews 275850
aurelia reviews 275850 -t negative -f all
aurelia reviews 275850 --cursor 'AoJ4...'     # next page