Steam API endpoint
Returns the store's weekly top-sellers chart for a country, each rank carrying the full store item (name, price, weighted community tags, review summary, platforms). cc selects the country whose sales ranking and currency are returned.
/steam/top-sellersQuery parameters:
cc (optional, default us) — the country code (ISO) whose weekly sales ranking and price currency are returned.l (optional, default english) — Steam store language name.Returns country_code, start_date_unix (the week the ranking covers), count, ranks[] (each: rank, appid, item — the full store item, same shape as /steam/items), and source_url.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| rank | 20 | 1 to 20, median 10 |
| appid | 20 | |
| item | 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| cc | string | No | Country code (ISO) whose weekly sales ranking is returned | ||
| l | string | No | Steam store language name | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/steam/top-sellers" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"country_code": "US",
"start_date_unix": 1782777600,
"count": 1,
"ranks": [
{
"rank": 1,
"appid": 730,
"item": {
"appid": 730,
"name": "Counter-Strike 2",
"url": "https://store.steampowered.com/app/730/CounterStrike_2",
"review_summary": "Very Positive",
"platforms": {
"windows": true,
"mac": false,
"linux": true
},
"tags": [
{
"tagid": 1663,
"weight": 1160
}
]
}
}
],
"source_url": "https://api.steampowered.com/IStoreTopSellersService/GetWeeklyTopSellers/v1/?input_json=..."
}
}Request schema
No body schema
Response schema
#/definitions/steam.topSellersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | steam.TopSellersResponse | No | ||||
| data.count | integer | No | ||||
| data.country_code | string | No | ||||
| data.ranks | array | No | ||||
| data.ranks[].appid | integer | No | ||||
| data.ranks[].item | steam.CategoryItem | No | CategoryItem record, 25 fields: appid, developers, name, platforms, price_overview, publishers, release_date_unix, review_count, review_percent_positive, review_summary, short_description, tags and 2 more. Described under Steam Batch Store Items API. | |||
| data.ranks[].rank | integer | No | ||||
| data.source_url | string | No | ||||
| data.start_date_unix | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/steam/top-sellers" \
-H "x-api-key: $CRAWLORA_API_KEY"