Steam API endpoint
Returns the storefront merchandising buckets for a region: specials, top_sellers, new_releases, and coming_soon, each with its item list.
/steam/featured-categoriesReturns the storefront merchandising buckets for a region: specials, top sellers, new releases, and coming soon.
Query parameters:
cc (optional, default us) — store country code (ISO); selects the price currency.l (optional, default en) — language code.Returns specials, top_sellers, new_releases, and coming_soon, each a bucket with id, name, count, and items[] (each item: id, type, name, discounted, discount_percent, original_price, final_price, currency, header_image, windows_available, mac_available, linux_available), plus source_url.
| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| id | 30 | |
| name | 30 | “Subject 4471” and 29 other values |
| discounted | 30 | true in 16 of 30 |
| currency | 30 | USD in all 30 |
| header_image | 30 | shared.akamai.steamstatic.com |
| windows_available | 30 | true in 30 of 30 |
| mac_available | 30 | true in 5 of 30 |
| linux_available | 30 | true in 1 of 30 |
| discount_percent | 16 | 10 to 65, median 15 |
| original_price | 28 | 199 to 6,999, median 699 |
| final_price | 28 | 69 to 4,999, median 639 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| cc | string | No | Store country code (ISO, selects currency) | ||
| l | string | No | Language code | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/steam/featured-categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"specials": {
"id": "cat_specials",
"name": "Specials",
"count": 1,
"items": [
{
"id": 1174180,
"name": "Red Dead Redemption 2",
"discounted": true,
"discount_percent": 67,
"final_price": 1979,
"currency": "USD"
}
]
},
"top_sellers": {
"id": "cat_topsellers",
"name": "Top Sellers",
"count": 0,
"items": []
},
"new_releases": {
"count": 0,
"items": []
},
"coming_soon": {
"count": 0,
"items": []
},
"source_url": "https://store.steampowered.com/api/featuredcategories?cc=us&l=en"
}
}Request schema
No body schema
Response schema
#/definitions/steam.featuredCategoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | steam.FeaturedCategoriesResponse | No | ||||
| data.coming_soon | object | No | Bucket of upcoming releases. | |||
| data.coming_soon.count | integer | No | Number of items in the bucket. | |||
| data.coming_soon.id | string | No | Id of the bucket, as Steam names it. | |||
| data.coming_soon.items | array | No | Items in the bucket. | |||
| data.coming_soon.items[].currency | string | No | Currency code of the prices, such as `USD`. | |||
| data.coming_soon.items[].discount_percent | integer | No | Discount currently applied, as a percentage. | |||
| data.coming_soon.items[].discounted | boolean | No | Whether the item is currently discounted. | |||
| data.coming_soon.items[].final_price | integer | No | Price after any discount, in minor currency units such as cents. | |||
| data.coming_soon.items[].header_image | string | No | URL of the item's header image. | |||
| data.coming_soon.items[].id | integer | No | Steam id of the featured item. | |||
| data.coming_soon.items[].linux_available | boolean | No | Whether the item is available on Linux. | |||
| data.coming_soon.items[].mac_available | boolean | No | Whether the item is available on macOS. | |||
| data.coming_soon.items[].name | string | No | Name of the featured item. | |||
| data.coming_soon.items[].original_price | integer | No | Price before any discount, in minor currency units such as cents. | |||
| data.coming_soon.items[].type | integer | No | Numeric type code Steam gives the featured item. | |||
| data.coming_soon.items[].windows_available | boolean | No | Whether the item is available on Windows. | |||
| data.coming_soon.name | string | No | Display name of the bucket. | |||
| data.new_releases | object | No | Bucket of new releases. | |||
| data.new_releases.count | integer | No | Number of items in the bucket. | |||
| data.new_releases.id | string | No | Id of the bucket, as Steam names it. | |||
| data.new_releases.items | array | No | Items in the bucket. | |||
| data.new_releases.items[].currency | string | No | Currency code of the prices, such as `USD`. | |||
| data.new_releases.items[].discount_percent | integer | No | Discount currently applied, as a percentage. | |||
| data.new_releases.items[].discounted | boolean | No | Whether the item is currently discounted. | |||
| data.new_releases.items[].final_price | integer | No | Price after any discount, in minor currency units such as cents. | |||
| data.new_releases.items[].header_image | string | No | URL of the item's header image. | |||
| data.new_releases.items[].id | integer | No | Steam id of the featured item. | |||
| data.new_releases.items[].linux_available | boolean | No | Whether the item is available on Linux. | |||
| data.new_releases.items[].mac_available | boolean | No | Whether the item is available on macOS. | |||
| data.new_releases.items[].name | string | No | Name of the featured item. | |||
| data.new_releases.items[].original_price | integer | No | Price before any discount, in minor currency units such as cents. | |||
| data.new_releases.items[].type | integer | No | Numeric type code Steam gives the featured item. | |||
| data.new_releases.items[].windows_available | boolean | No | Whether the item is available on Windows. | |||
| data.new_releases.name | string | No | Display name of the bucket. | |||
| data.source_url | string | No | URL the data was read from. | |||
| data.specials | object | No | Bucket of items currently on special offer. | |||
| data.specials.count | integer | No | Number of items in the bucket. | |||
| data.specials.id | string | No | Id of the bucket, as Steam names it. | |||
| data.specials.items | array | No | Items in the bucket. | |||
| data.specials.items[].currency | string | No | Currency code of the prices, such as `USD`. | |||
| data.specials.items[].discount_percent | integer | No | Discount currently applied, as a percentage. | |||
| data.specials.items[].discounted | boolean | No | Whether the item is currently discounted. | |||
| data.specials.items[].final_price | integer | No | Price after any discount, in minor currency units such as cents. | |||
| data.specials.items[].header_image | string | No | URL of the item's header image. | |||
| data.specials.items[].id | integer | No | Steam id of the featured item. | |||
| data.specials.items[].linux_available | boolean | No | Whether the item is available on Linux. | |||
| data.specials.items[].mac_available | boolean | No | Whether the item is available on macOS. | |||
| data.specials.items[].name | string | No | Name of the featured item. | |||
| data.specials.items[].original_price | integer | No | Price before any discount, in minor currency units such as cents. | |||
| data.specials.items[].type | integer | No | Numeric type code Steam gives the featured item. | |||
| data.specials.items[].windows_available | boolean | No | Whether the item is available on Windows. | |||
| data.specials.name | string | No | Display name of the bucket. | |||
| data.top_sellers | object | No | Bucket of the store's top-selling items. | |||
| data.top_sellers.count | integer | No | Number of items in the bucket. | |||
| data.top_sellers.id | string | No | Id of the bucket, as Steam names it. | |||
| data.top_sellers.items | array | No | Items in the bucket. | |||
| data.top_sellers.items[].currency | string | No | Currency code of the prices, such as `USD`. | |||
| data.top_sellers.items[].discount_percent | integer | No | Discount currently applied, as a percentage. | |||
| data.top_sellers.items[].discounted | boolean | No | Whether the item is currently discounted. | |||
| data.top_sellers.items[].final_price | integer | No | Price after any discount, in minor currency units such as cents. | |||
| data.top_sellers.items[].header_image | string | No | URL of the item's header image. | |||
| data.top_sellers.items[].id | integer | No | Steam id of the featured item. | |||
| data.top_sellers.items[].linux_available | boolean | No | Whether the item is available on Linux. | |||
| data.top_sellers.items[].mac_available | boolean | No | Whether the item is available on macOS. | |||
| data.top_sellers.items[].name | string | No | Name of the featured item. | |||
| data.top_sellers.items[].original_price | integer | No | Price before any discount, in minor currency units such as cents. | |||
| data.top_sellers.items[].type | integer | No | Numeric type code Steam gives the featured item. | |||
| data.top_sellers.items[].windows_available | boolean | No | Whether the item is available on Windows. | |||
| data.top_sellers.name | string | No | Display name of the bucket. | |||
| 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/featured-categories" \
-H "x-api-key: $CRAWLORA_API_KEY"