Documentation menu
Choosing fields
By default, GET /games only returns each game's id and name —
that keeps responses small and fast. Ask for more with fieldset:
GET /games?fieldset=developer,release_date,final_price_us,score,minified_tags&tags_limit=5
{
"id": 292030,
"name": "The Witcher 3: Wild Hunt",
"developers": ["CD PROJEKT RED"],
"releaseDate": 1431918000000,
"prices": { "us": { "finalPrice": 39.99 } },
"historicalReviews": { "score": 96.8 },
"minified_tags": ["Mundo abierto", "Rol", "Buena trama", "Atmosféricos", "Fantasía"]
}
Notice that fields come back with their stored names and structure: final_price_us shows up as
prices.us.finalPrice, and score as historicalReviews.score.
Available fields
| Group | Fields |
|---|---|
| Basics | developer, publisher, genres, categories, tags, minified_tags, short_description, isF2P, min_age, content_restrictions, origin_country |
| Release | release_date, releaseDateOrig, coming_soon |
| Early access | is_early_access, has_left_early_access, is_possibly_abandoned, ea_release_date_from, ea_release_date_to, ea_release_date_orig |
| Media | header_image, background, screenshots, videoId, steamImages |
| Price | price (all price data), final_price_ar, final_price_us, initial_price, us_initial_price, discount_percent, currency, regional_status |
| Reviews | historical_reviews, last_month, release_window (a whole window), or single values like score, total_reviews, last_month_score, release_window_reviews |
| Popularity & region lock | wishlist_rank, wishlist_rank_max, wishlist_rank_current, is_limited, limitedStatus |
Tips
minified_tagsis usually what you want — tags as a plain list of names, most representative first.- Use
tags_limitto only get each game's top N tags.tags_limit=5is plenty for a UI. - Need everything about one game?
GET /games/{id}returns the full record.