GET /developer/v1/games/:id

Reference for reading one tracked game in full - every GameDetail field, sort placements, recommendations, changes and Rolimon's reading.

Endpoints / Market data / One game

Answers one game the platform tracks in full: everything in its GameSummary, plus its description, peak, placements in Roblox's sorts, recommendations and recent changes. It answers what the panel's game page reads.

Request to GET /developer/v1/games/:id

GET/developer/v1/games/:id

Path

idnumberRequired
The game's Roblox universe id: a positive whole number in plain digits.

Headers

AuthorizationstringRequired
Bearer bk_live_<the game's key>.
If-None-Matchstring
The ETag of the last answer, for a 304 when nothing changed.
HTTP
GET https://studio.blockoutgames.com/developer/v1/games/1001Authorization: Bearer bk_live_<the game's key>

A game the platform does not track is 404

Unlike the panel's game page, this route never looks a game up on Roblox and never starts tracking it: an untracked id is 404 not_found. A game's key therefore cannot spend the collector's Roblox budget. To have a game tracked, ask a studio owner to open its page in the panel (/games/<universe id>); the collector takes its first reading on its next pass. A game discovered but not yet read answers with its readings empty.

What GET /developer/v1/games/:id answers

200 with a GameDetail: every GameSummary field, then these.

JSON
{  "id": 1001,  "rootPlaceId": 2001,  "name": "Rising Tycoon",  "iconUrl": "https://tr.rbxcdn.com/…/512/512/Image/Webp/noFilter",  "creator": { "type": "User", "id": 3001, "name": "builder", "hasVerifiedBadge": false },  "genreL1": "Simulation",  "genreL2": "Tycoon",  "tier": "hot",  "ccu": 6000,  "visits": 1200000,  "favorites": 45000,  "likeRatio": 0.88,  "createdAt": "2026-09-30T12:00:00.000Z",  "lastSnapshotAt": "2026-10-24T09:58:00.000Z",  "growth1h": 0.5,  "growth6h": 1.4,  "growth24h": 3.2,  "growth7d": null,  "growthDaily": 2.1,  "visits24h": 210000,  "favorites24h": 9000,  "velocity": 1300,  "acceleration": 250,  "risingHours": 6,  "volatility": 0.21,  "peakRatio": 0.97,  "breakout": 81,  "description": "Build the tallest tycoon.",  "maxPlayers": 12,  "price": null,  "upVotes": 8800,  "downVotes": 1200,  "updatedAt": "2026-10-24T08:12:00.000Z",  "observedPeakCcu": 6200,  "observedPeakAt": "2026-10-24T09:40:00.000Z",  "firstSeenAt": "2026-10-02T07:00:00.000Z",  "discoveredVia": "sort:up-and-coming",  "avgCcu24h": 2900,  "placements": [    {      "sortId": "up-and-coming",      "displayName": "Up-and-Coming",      "rank": 4,      "isSponsored": false,      "observedAt": "2026-10-24T09:50:00.000Z"    }  ],  "recommends": [    {      "rank": 1,      "id": 1003,      "name": "Other Tycoon",      "iconUrl": null,      "ccu": 800,      "genreL1": "Simulation"    }  ],  "recommendedBy": [],  "recommendedByCount": 0,  "changes": [    {      "observedAt": "2026-10-20T15:00:00.000Z",      "field": "name",      "oldValue": "Tycoon",      "newValue": "Rising Tycoon"    }  ],  "rolimons": { "players": 5900, "seenAt": "2026-10-24T09:50:00.000Z" }}

Every GameDetail field beyond the summary

GameDetail

descriptionstring | null
The game's description on Roblox, as of the last reading.
maxPlayersnumber | null
Server size.
pricenumber | null
Price in Robux for paid access, as Roblox reports it.
upVotesnumber | null
Upvotes at the last reading.
downVotesnumber | null
Downvotes at the last reading.
updatedAtstring | null
Roblox's "updated" time. It changes every few minutes for some games, so it is not a clean "update published" signal.
observedPeakCcunumber | null
The most players seen since tracking began, not the all-time peak.
observedPeakAtstring | null
When that peak was seen.
firstSeenAtstring
When the platform started tracking the game.
discoveredViastring
How it entered the platform: sort:<sort id>, recommendation, creator, rolimons, manual (a member opened it), snapshot or icons.
avgCcu24hnumber | null
Mean players over the last 24 hours.
placementsSortPlacement[]
Where the game is in Roblox's discovery sorts at the latest sort reading within the last hour, best rank first: sortId, displayName, rank, isSponsored (a paid placement) and observedAt.
recommendsRelatedGame[]
The games Roblox recommends from this game's page, at its latest reading within 7 days, by rank: rank, id, name, iconUrl, ccu, genreL1.
recommendedByRelatedGame[]
Up to 12 games whose pages recommended this one in the last 2 days, most players first, each with its best rank.
recommendedByCountnumber
How many games recommended this one in the last 2 days.
changesGameChange[]
The last 50 changes to the game, newest first: observedAt, field (name, description, genre_l1, genre_l2, icon_url, max_players, price), oldValue, newValue. Roblox's "updated" time is left out.
rolimonsobject | null
What Rolimon's last saw of the game, players and seenAt, when it is on Rolimon's list; else null.

How GET /developer/v1/games/:id is cached

From the platform's read cache, fresh for 60 seconds and replaced when the collector stores new market data. Answers carry ETag and X-Cache. The Template's PlatformService.game(id) keeps an answer for 60 seconds.

Errors from GET /developer/v1/games/:id

Statuserror.codeWhen
400validation_failedThe id is not a positive whole number in plain digits
401unauthenticatedThe key is missing, malformed, wrong or revoked, or its game left the catalog
404not_foundThe platform does not track that game; message is Game not found
429rate_limitedOver a limit; wait the Retry-After seconds

Bodies and what to do: Errors, limits and polling.

Updated