# Steam (/docs/steam) Search the Steam store and read one game or app with its price, discount, developers, genres, Metacritic score and recommendations Steam is the largest PC game store. These endpoints search the store by title and read one app in full: its price and discount in any country's store, developers and publishers, genres, release date, Metacritic score, recommendation count and screenshots. Every result uses the canonical `Product` shape, and the Steam-only facts sit in `product.ext.steam`. Base URL: `/v1/steam/...` Steam exposes 2 routes here. ## Quickstart ### Search the store Pass a game or software title as `query`. Results come in Steam's own ranking. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/steam/search?query=portal" \ -H "x-api-key: YOUR_API_KEY" ``` ### Read one app Take `product.id` (the app id) from a search row, or the number in a store link: `store.steampowered.com/app/620/` is `620`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/steam/app?app_id=620" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "product": { "id": "620", "title": "Portal 2", "brand": "Valve", "price": { "current": 9.99, "original": null, "currency": "USD" }, "availability": "Available", "ext": { "steam": { "type": "game", "genres": ["Action", "Adventure"], "release_date": "Apr 18, 2011", "metacritic_score": 95, "recommendations": 393264 } } } } } ``` ## Questions people ask ### Can I get prices for another country? Yes. Pass `country` as a two-letter code, for example `GB` or `DE`. The price comes back in that store's currency, and what is on sale follows that store. ### Can I get the text in another language? Yes. Pass `language` as a Steam language name, for example `german` or `french`. The release date then reads as Steam shows it in that language, for example `9. Dez. 2020` in German. ### How do I see a discount? On sale, `product.price.original` is the price before the discount and `product.ext.steam.discount_percent` the percentage. Outside a sale `original` is null. ### Why is there no star rating? Steam does not give these surfaces a star average. `product.ext.steam.recommendations` is the number of recommendations, and `metacritic_score` the critics' score where Metacritic has one. ## All endpoints **Country and region** `country` and `region` do different jobs on different endpoints. Each line below says what the parameter does there. [How they differ](/docs/data-availability.md#country-and-region). - `country` on `/v1/steam/app`, `/v1/steam/search`: Two-letter country code that sets the store, the currency and what is on sale, for example US (default), GB or DE. ## Platform notes **Search returns one page.** Up to 10 matches, ranked by Steam; refine the title to reach others. **A free app costs 0.** `product.price.current` is `0` when Steam marks the app free, and null when it simply shows no price. **An app id Steam does not know answers `404`** and is not charged. ## Next steps - [Pagination](/docs/pagination.md): How list endpoints page. - [Errors](/docs/errors.md): What each status means and which ones are refunded.