Steam

List Steam charts

List Steam's most played, daily peak and weekly top sellers charts.

GET/v1/steam/charts
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
chartstringquery

`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`.

one of: most_played, daily_peak, top_sellers

countrystringquery

`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`.

pattern: ^[A-Za-z]{2}$

weekstringquery

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.

pattern: ^\d{4}-\d{2}-\d{2}$

languagestringquery

Language of the text: a Steam language name or short code such as `german` or `de`. Default: `en`.

limitintegerquery

Entries to return, 1 to 100. Default: 100.

≥ 1 · ≤ 100

Response fields
25

Endpoint-specific response payload.

datachart
string

Which chart this is.

one of: most_played, daily_peak, top_sellers

datacountry
stringnullable

Country of a `top_sellers` chart; null for the other charts.

dataasOf
stringnullable

When the data is from (ISO 8601 UTC): the last update for `most_played`, the day for `daily_peak`, the start of the week for `top_sellers`.

Chart entries, best first.

dataentries[]rank
integer

Position in the chart, 1 is first.

dataentries[]appId
integer

Steam app id.

dataentries[]name
stringnullable

Name of the app; null when the name could not be looked up.

dataentries[]url
string

Store page URL.

dataentries[]isFree
booleannullable

Whether the app is free; null when the chart does not state it and the app carries no price.

Price; set for top sellers, null otherwise.

dataentries[]pricecurrency
stringnullable

ISO currency code, e.g. `USD`, when known; otherwise null.

dataentries[]priceinitial
integernullable

Price before any discount, in hundredths of the currency unit (divide by 100, also for yen and won). Null when only the discounted price is available and the currency could not be determined.

dataentries[]pricefinal
integernullable

Price to pay now, in hundredths of the currency unit (divide by 100, also for yen and won).

dataentries[]pricediscountPercent
integer

Current discount, 0 to 100.

dataentries[]priceinitialFormatted
stringnullable

Price before discount as text, e.g. `$19.99`; null when there is no discount or no formatted price is available, as on suggestions and featured items.

dataentries[]pricefinalFormatted
stringnullable

Price now as text, e.g. `$9.99`; null when no formatted price is available, as on suggestions and featured items.

dataentries[]currentPlayers
integernullable

Players right now (`most_played` only).

dataentries[]peakPlayers
integernullable

Peak players: today's so far for `most_played`, yesterday's for `daily_peak`.

dataentries[]lastWeekRank
integernullable

Rank a week earlier; null when the app was not in the chart then.

dataentries[]consecutiveWeeks
integernullable

Weeks in a row in the top sellers chart (`top_sellers` only).

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/steam/charts?chart=most_played" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Steam chart entries.