API reference · Games

Get one game

GEThttp://localhost:8000/games/{id}

Everything we know about a single game: prices, all review windows, every tag with its ranking, screenshots, early access history and more.

You need its Steam app ID — the number in its store URL. For store.steampowered.com/app/292030/The_Witcher_3_Wild_Hunt/ it's 292030.

Request

curl "http://localhost:8000/games/292030" \
  -H "Authorization: Bearer YOUR_TOKEN"

Try itLive API

GET http://localhost:8000/games/292030

Runs against the real API with a shared demo key. Results are fixed at 5 per page and identical requests are served from a cache for an hour.

Parameters

Path1

idintegerrequired
The game's Steam app ID.

Responses

200The game

Body

idinteger
Steam app ID
namestring
developersstring[]
publishersstring[]
releaseDateinteger
Release date as a millisecond timestamp
shortDescriptionstring
mainImageUrlstring
Header image from the Steam store
genresobject[]
- idstring
- descriptionstring
minified_tagsstring[]
The game's tags, most representative first
pricesobject
Prices per store (ar, us)
historicalReviewsobject
Review stats for one time window
- scorenumber
  Percentage of positive reviews (0–100)
- reviewsQuantityinteger
- positiveReviewsinteger
- negativeReviewsinteger
early_accessobject
appIdinteger
releaseDateOrigstring
Release date as shown on Steam
comingSoonboolean
isF2Pboolean
videoidinteger | null
Trailer ID, if the game has one
backgroundUrlstring
screenshotsUrlsobject[]
- idinteger
- path_thumbnailstring
- path_fullstring
lastMonthReviewsobject
Review stats for one time window
- scorenumber
  Percentage of positive reviews (0–100)
- reviewsQuantityinteger
- positiveReviewsinteger
- negativeReviewsinteger
releaseWindowReviewsobject
Review stats for one time window
- scorenumber
  Percentage of positive reviews (0–100)
- reviewsQuantityinteger
- positiveReviewsinteger
- negativeReviewsinteger

Example

{
  "id": 292030,
  "name": "The Witcher 3: Wild Hunt",
  "developers": [
    "CD PROJEKT RED"
  ],
  "publishers": [
    "CD PROJEKT RED"
  ],
  "releaseDate": 1431918000000,
  "shortDescription": "Eres Geralt de Rivia, cazador de monstruos...",
  "mainImageUrl": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/292030/header.jpg",
  "genres": [
    {
      "id": "3",
      "description": "Rol"
    }
  ],
  "minified_tags": [
    "Mundo abierto",
    "Rol",
    "Buena trama",
    "Atmosféricos",
    "Fantasía"
  ],
  "prices": {
    "ar": {
      "finalPrice": 29.99,
      "currentDiscount": 0
    },
    "us": {
      "finalPrice": 39.99
    }
  },
  "historicalReviews": {
    "score": 96.8,
    "reviewsQuantity": 807345,
    "positiveReviews": 0,
    "negativeReviews": 0
  },
  "early_access": {
    "has_ea_data": false
  },
  "appId": 292030,
  "releaseDateOrig": "18 MAY 2015",
  "comingSoon": false,
  "isF2P": false,
  "videoid": 256927226,
  "backgroundUrl": "https://store.akamai.steamstatic.com/images/storepagebackground/app/292030",
  "screenshotsUrls": [
    {
      "id": 0,
      "path_thumbnail": "string",
      "path_full": "string"
    }
  ],
  "lastMonthReviews": {
    "score": 96.8,
    "reviewsQuantity": 807345,
    "positiveReviews": 0,
    "negativeReviews": 0
  },
  "releaseWindowReviews": {
    "score": 96.8,
    "reviewsQuantity": 807345,
    "positiveReviews": 0,
    "negativeReviews": 0
  }
}

401Your token is missing or invalid

Body

errorstring
Short name of the error
messagestring
What went wrong, in more detail

Example

{
  "error": "Unauthorized"
}

404There's no game with that ID

Body

errorstring
Short name of the error
messagestring
What went wrong, in more detail

Example

{
  "error": "Not Found",
  "message": "No game found with ID 1"
}

429You've used all the requests in your plan for this billing cycle

Headers

Retry-AfterSeconds until your quota resets

Body

errorstring
limitinteger

Example

{
  "error": "Request limit reached for your plan in the current billing cycle",
  "limit": 10000
}