steamdb.info APIsteamdb.info ↗
Access SteamDB data via API: trending games, most played, top rated, current sales, free promotions, and full game details including price history.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9d2dd578-17d8-42f1-9cf5-171bd44847cb/get_free_promotions' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve currently active and upcoming free game promotions on Steam. Returns active promotions with full details and upcoming promotions with estimated dates.
No input parameters required.
{
"type": "array",
"fields": {
"name": "string, game title",
"app_id": "string or null, Steam application ID",
"status": "string, 'active' or 'upcoming'",
"end_time": "string or null, ISO datetime for active promotions",
"image_url": "string or null, header image URL",
"start_time": "string or null, ISO datetime or rough date string",
"store_link": "string or null, Steam store link",
"promotion_type": "string, type of promotion (e.g. 'Free to Keep', 'Upcoming')"
},
"sample": {
"data": [
{
"name": "Overcome Your Fears - Caretaker",
"app_id": "3550490",
"status": "active",
"end_time": "2026-05-07T15:00:00+00:00",
"image_url": "https://shared.fastly.steamstatic.com/store_item_assets/steam/apps/3550490/cbd34ac4c5465cd866035baad4f75ec11293aea1/header.jpg",
"start_time": "2026-05-01T15:00:00+00:00",
"store_link": "https://store.steampowered.com/app/3550490/?curator_clanid=4777282&utm_source=SteamDB",
"promotion_type": "Free to Keep"
},
{
"name": "AquaDream Soundtrack",
"app_id": null,
"status": "upcoming",
"end_time": null,
"image_url": null,
"start_time": "May 2026",
"store_link": null,
"promotion_type": "Upcoming"
}
],
"status": "success"
}
}About the steamdb.info API
The SteamDB API exposes 7 endpoints covering trending games, current sales, free promotions, player counts, and per-game details from SteamDB.info. Use get_game_details to pull price history across currencies and third-party owner estimations for any Steam app ID, or use get_free_promotions to list active and upcoming free-to-keep titles with start and end times.
What the API Covers
The SteamDB API surfaces data from SteamDB.info across seven endpoints. Discovery endpoints — get_trending_games, get_most_played_games, and get_top_rated_games — return ranked lists with fields like current_players, peak_24h, all_time_peak, rating_percentage, and reviews_count. The get_current_sales endpoint returns active discounts with discount (e.g. -25%), price, rating, and ends date per game. All list endpoints include app_id, which you can pass downstream to get_game_details.
Game Details and Price History
get_game_details accepts a single appid parameter (e.g. 730 for Counter-Strike 2, 570 for Dota 2) and returns price_history_summary — an array of objects with currency, current_price, and lowest_recorded — plus owner_estimations from multiple third-party providers. This makes it useful for tracking historical pricing across regions or estimating install base from independent sources.
Promotions and Search
get_free_promotions returns both active and upcoming promotions, including start_time, end_time, promotion_type (e.g. Free to Keep), and a direct store_link. The search_games endpoint accepts a query string and returns matching titles with their app_id and type, useful for resolving a game name to its Steam application ID before calling get_game_details.
- Monitor free-to-keep Steam promotions and alert users before the
end_timeexpires - Build a Steam sale tracker that surfaces discounts above a threshold using the
discountfield fromget_current_sales - Compare current and lowest-ever prices across currencies using
price_history_summaryfromget_game_details - Display a live 'most played' leaderboard using
current_playersandpeak_24hfromget_most_played_games - Estimate Steam game ownership across providers using the
owner_estimationsarray inget_game_details - Resolve game titles to Steam app IDs programmatically using
search_gamesbefore fetching full details - Track trending title momentum by polling
get_trending_gamesfollower counts over time
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SteamDB have an official developer API?+
What does `get_game_details` return that the other endpoints don't?+
get_game_details is the only endpoint that returns price_history_summary — lowest recorded and current prices per currency — and owner_estimations from named third-party providers. The other endpoints return current snapshot data (rankings, player counts, discount percentages) but no historical pricing or ownership figures.Does `get_free_promotions` distinguish between games that are permanently free and time-limited promotions?+
promotion_type field indicates the nature of each promotion (e.g. Free to Keep, Upcoming), and the status field is either active or upcoming. Active promotions include an end_time in ISO datetime format; upcoming ones include a start_time which may be a rough date string rather than a precise timestamp.Does the API cover DLC, software, or non-game Steam apps?+
search_games does return a type field that can surface non-game app types, and get_game_details works for any valid appid. Dedicated endpoints for DLC-only catalogs, Steam software titles, or bundles are not currently included. You can fork this API on Parse and revise it to add endpoints targeting those app categories.