# Social Fetch API - Steam endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

19 documented Steam operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/steam/apps/{appId}/reviews
List Steam app reviews
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/reviews/get.mdx
SDK: client.steam.getAppReviews({ appId: 620, language: "english", limit: 20 })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
- language (optional, string) - Language the reviews are written in, as a Steam name or short code such as `english` or `en`, or `all`. Default: `all`.
- sort (optional, string, enum: recent | updated | helpful) - `recent` is newest first and reaches the first review; `updated` is by last edit; `helpful` is Steam's helpfulness ranking and only looks at the last `days` days. Default: `recent`.
- sentiment (optional, string, enum: all | positive | negative) - Only reviews that recommend (`positive`) or don't recommend (`negative`) the app. Default: `all`.
- purchase (optional, string, enum: all | steam | other) - `steam` is reviews by people who bought on Steam, `other` is activated keys and free copies. Default: `all`.
- minPlaytimeHours (optional, number) - Only reviews by players with at least this many hours in the app. Must not exceed `maxPlaytimeHours`.
- maxPlaytimeHours (optional, number) - Only reviews by players with at most this many hours in the app. Must be at least `minPlaytimeHours`.
- from (optional, string) - Only reviews written on or after this date (UTC). Must be on or before `to`.
- to (optional, string) - Only reviews written on or before this date (UTC). Must be on or after `from`.
- days (optional, integer) - With `sort=helpful`: how many days back to rank, 1 to 365. Default: 365.
- limit (optional, integer) - Reviews per page, 1 to 100. Default: 20.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response, with the same filters, to get the next page.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/reviews?language=english&limit=20" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}/reviews/summary
Get Steam app review summary
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/reviews/summary/get.mdx
SDK: client.steam.getAppReviewsSummary({ appId: 620, language: "all" })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
- language (optional, string) - Language the reviews are written in, as a Steam name or short code such as `english` or `en`, or `all`. Default: `all`.
- purchase (optional, string, enum: all | steam | other) - `steam` is reviews by people who bought on Steam, `other` is activated keys and free copies. Default: `all`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/reviews/summary?language=all" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}/reviews/histogram
Get Steam app review histogram
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/reviews/histogram/get.mdx
SDK: client.steam.getAppReviewsHistogram({ appId: 620 })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/reviews/histogram" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}
Get Steam app
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/get.mdx
SDK: client.steam.getApp({ appId: 620, country: "US" })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
- country (optional, string) - Country the prices are shown for, as an ISO 3166-1 alpha-2 code. Default: `US`. An app not sold in this country returns `lookupStatus` `not_found` with `unavailableInCountry` true.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620?country=US" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps
Get several Steam apps
Credit cost: 1 credit per app id. Up to 100 app ids per request. Max 100 credits. An id Steam does not know is still charged. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/get.mdx
SDK: client.steam.getAppsBatch({ ids: "570,730" })
Parameters:
- ids (required, array) - Steam app ids, comma-separated, 1 to 100, e.g. `570,730,620`. Duplicates are dropped.
- fields (optional, string, enum: compact | full) - `compact` (default) returns the fields lists use. `full` adds a short description, franchises, platforms, category ids, tags, languages, trailers, screenshots, purchase options and images.
- country (optional, string) - Country the prices are shown for, as an ISO 3166-1 alpha-2 code. Default: `US`. An app not sold in this country returns `lookupStatus` `not_found` with `unavailableInCountry` true.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
curl "https://api.socialfetch.dev/v1/steam/apps?ids=570,730" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}/players
Get Steam app player count
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/players/get.mdx
SDK: client.steam.getAppPlayers({ appId: 620 })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/players" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}/news
List Steam app news
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/news/get.mdx
SDK: client.steam.getAppNews({ appId: 620, limit: 20 })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
- limit (optional, integer) - News items per page, 1 to 100. Default: 20.
- before (optional, string) - Only items published before this date or timestamp (UTC).
- feeds (optional, string) - Only these feeds, comma-separated by feed name, e.g. `steam_community_announcements`. Each item's `feed.name` says which feed it came from.
- full (optional, boolean) - Return each item's full contents. By default contents are cut at 500 characters.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response, with the same filters, to get the next page.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/news?limit=20" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}/achievements
List Steam app achievements
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/achievements/get.mdx
SDK: client.steam.getAppAchievements({ appId: 620 })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/achievements" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/search
Search Steam store
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/search/get.mdx
SDK: client.steam.searchApps({ query: "portal" })
Parameters:
- query (optional, string) - Words to search the store for, e.g. `portal`.
- category (optional, string, enum: games | software | dlc | demos | mods | hardware | videos | soundtracks) - Only this kind of item. Without it, search covers everything.
- tags (optional, array) - Only apps with all of these tag ids, comma-separated, e.g. `1684,19`. Tag ids are in the tags endpoint.
- developer (optional, string) - Only apps by this developer, by name.
- publisher (optional, string) - Only apps by this publisher, by name.
- sort (optional, string, enum: relevance | released | name | price_low | price_high | reviews) - `relevance` (default) is Steam's ranking and can reorder between requests, so a walk can repeat rows across pages. `released` (newest first) and `name` (A to Z) are stable; the others are as named.
- onSale (optional, boolean) - Only apps with a discount right now.
- os (optional, string, enum: windows | mac | linux) - Only apps that run on this operating system.
- maxPrice (optional) - Highest price in whole currency units, e.g. `10`, or `free` for free apps only.
- supportedLanguage (optional, string) - Only apps with this language supported, as a short code such as `de`.
- country (optional, string) - Country the prices are shown for, as an ISO 3166-1 alpha-2 code. Default: `US`.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
- limit (optional, integer) - Results per page, 1 to 100. Default: 25.
- page (optional, integer) - Page number (1-based). Default: 1.
Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/steam/apps/search?query=portal" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/browse
List Steam store catalogue
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/browse/get.mdx
SDK: client.steam.browseApps({ tags: "492", sort: "appid" })
Parameters:
- type (optional, string, enum: game | dlc | demo | software | video | hardware | mod | series | music) - Only this kind of item. Without it, every kind is listed.
- tags (optional, array) - Only apps with all of these tag ids, comma-separated, e.g. `1684,19`.
- excludeTags (optional, array) - Leave out apps with any of these tag ids, comma-separated.
- status (optional, string, enum: released | coming_soon | any) - `released` (default), `coming_soon` for apps not out yet, or `any`.
- price (optional, string, enum: free | paid) - Only free apps, or only apps that cost money.
- minDiscount (optional, integer) - Only apps discounted by at least this many percent.
- minReviewScore (optional, integer) - Only apps whose Steam review score is at least this, 1 to 9 (9 is overwhelmingly positive). Apps without reviews are left out.
- releasedFrom (optional, string) - Only apps released on or after this date (UTC).
- releasedTo (optional, string) - Only apps released on or before this date (UTC).
- contentDescriptors (optional, array) - Only apps with all of these content descriptor ids, e.g. `3` for adult sexual content.
- excludeContentDescriptors (optional, array) - Leave out apps with any of these content descriptor ids.
- parentAppId (optional, integer) - Only DLC and demos of this app.
- sort (optional, string, enum: popular | name | appid) - `popular` (default) is Steam's popularity order; `name` is A to Z; `appid` is by app id, which is stable and lists the whole catalogue page by page.
- fields (optional, string, enum: compact | ids) - `compact` (default) returns app records; `ids` returns only app ids and allows up to 1,000 per page.
- country (optional, string) - Country the prices are shown for, as an ISO 3166-1 alpha-2 code. Default: `US`.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
- limit (optional, integer) - Results per page. 1 to 100 for `compact` (default 25); 1 to 1,000 for `ids` (default 100).
- page (optional, integer) - Page number (1-based). Default: 1.
Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/steam/apps/browse?tags=492&sort=appid" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/suggest
Get Steam search suggestions
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/suggest/get.mdx
SDK: client.steam.suggestApps({ query: "portal" })
Parameters:
- query (required, string) - Words to look up, e.g. `portal`.
- country (optional, string) - Country the prices are shown for, as an ISO 3166-1 alpha-2 code. Default: `US`.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
curl "https://api.socialfetch.dev/v1/steam/apps/suggest?query=portal" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/charts
List Steam charts
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/charts/get.mdx
SDK: client.steam.getCharts({ chart: "most_played" })
Parameters:
- chart (optional, string, enum: most_played | daily_peak | top_sellers) - `most_played`: top 100 by players right now; `daily_peak`: top 100 by yesterday's peak players; `top_sellers`: top 100 by sales for a week. Default: `most_played`.
- country (optional, string) - `top_sellers` uses this country's chart and prices; `most_played` and `daily_peak` ignore it and return `country` null. Must be a country Steam has a top-sellers chart for. Default: `US`.
- week (optional, string) - With `top_sellers`: any date in the week you want; Steam snaps it to the week's start. Dates after today are refused. Default: the current week.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
- limit (optional, integer) - Entries to return, 1 to 100. Default: 100.
curl "https://api.socialfetch.dev/v1/steam/charts?chart=most_played" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/tags
List Steam store tags
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/tags/get.mdx
SDK: client.steam.listTags({ popular: true })
Parameters:
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
- popular (optional, boolean) - Only the most popular tags, in popularity order.
curl "https://api.socialfetch.dev/v1/steam/tags?popular=true" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/featured
Get Steam featured items
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/featured/get.mdx
SDK: client.steam.getFeatured({ country: "US" })
Parameters:
- country (optional, string) - Country the prices are shown for, as an ISO 3166-1 alpha-2 code. Default: `US`.
- language (optional, string) - Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.
curl "https://api.socialfetch.dev/v1/steam/featured?country=US" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/apps/{appId}/community
Get Steam app community hub
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/apps/appid/community/get.mdx
SDK: client.steam.getAppCommunity({ appId: 620 })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/apps/620/community" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/market/items
Search Steam Community Market
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/market/items/get.mdx
SDK: client.steam.searchMarketItems({ query: "ak-47", appId: 730 })
Parameters:
- query (optional, string) - Words to search item names for, e.g. `ak-47`.
- appId (optional, integer) - Only items of this app, e.g. `730` for Counter-Strike 2.
- page (optional, integer) - Page number (1-based). Default: 1.
Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/steam/market/items?query=ak-47&appId=730" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/market/item
Get Steam Community Market price
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/market/item/get.mdx
SDK: client.steam.getMarketItemPrice({ appId: 730, name: "AK-47 | Redline (Field-Tested)" })
Parameters:
- appId (required, integer) - Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.
- name (required, string) - The item's market name, as `hashName` in the market search, e.g. `AK-47 | Redline (Field-Tested)`.
- currency (optional, integer) - Currency id for the prices: 1 USD (default), 2 GBP, 3 EUR, 5 RUB, 6 PLN, 7 BRL, 8 JPY, 9 NOK, 10 IDR, 11 MYR, 12 PHP, 13 SGD, 14 THB, 15 VND, 16 KRW, 17 TRY, 18 UAH, 19 MXN, 20 CAD, 21 AUD, 22 NZD, 23 CNY, 24 INR.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/market/item?appId=730&name=AK-47%20|%20Redline%20(Field-Tested)" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/groups/{name}
Get Steam group
Credit cost: 1 credit. Failed requests are free. A not-found answer is still charged.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/groups/name/get.mdx
SDK: client.steam.getGroup({ name: "SteamDB" })
Parameters:
- name (required, string) - The group's URL name, the part after `steamcommunity.com/groups/`, e.g. `SteamDB`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/steam/groups/SteamDB" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/steam/hardware-survey
Get Steam Hardware Survey
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/steam/hardware-survey/get.mdx
SDK: client.steam.getHardwareSurvey()
curl "https://api.socialfetch.dev/v1/steam/hardware-survey" \
  -H "x-api-key: YOUR_API_KEY"