Answers a page of the games the platform tracks, as the panel's Explore table lists them, or only the games named in ids. It is how a game reads the current players of many games in one call.
Request to GET /developer/v1/games
GET/developer/v1/games
Headers
AuthorizationstringRequiredBearer bk_live_<the game's key>.If-None-Matchstring- The
ETagof the last answer; an unchanged answer is then304with no body.
Query
idsstring- 1 to 100 universe ids separated by commas, such as
1001,1002. Only these games are answered. Any order, repeats allowed: they are read as a set. qstring- Up to 100 characters. Games whose name contains it, ignoring case.
sortstring- The order, one of the sort
values. Default
ccu. dirstringdesc(default) orasc. Games with no value for the sort come last either way, then by id.genrestring- Up to 100 characters. Only games whose first-level genre (
genreL1) is exactly this, such asSimulation. tierstringhot,active,warm,coldordead. Without it,deadgames are left out, unlessidsis given.minCcunumber- 0 to 100,000,000. Only games with at least this many players now.
maxCcunumber- 0 to 100,000,000. Only games with at most this many players now.
maxAgeDaysnumber- 1 to 10,000. Only games created on Roblox within this many days.
limitnumber- 1 to 100 games a page. Default 50, or 100 when
idsis given without alimit. offsetnumber- 0 to 1,000,000 games to skip. Default 0.
An empty parameter (genre=) counts as not set. A parameter the route does not read is ignored.
GET https://studio.blockoutgames.com/developer/v1/games?ids=1002,1001,999999Authorization: Bearer bk_live_<the game's key>Reading up to 100 games at once by id
With ids the answer holds only those games, sorted by sort (players, most first, by default), all on one page. A game asked for by id is answered whatever its tier, a dead one too, unless tier is given. An id the platform does not track, or has never read, is simply absent: no error, and no lookup on Roblox. ids=2,1 and ids=1,2,2 are the same request and share one cached answer. The other filters still apply alongside ids.
Read the games a game needs in one call this way, never one /games/:id each. Through the Template's shared cache, keep to about 40 ids a call: see The Template's platform service.
The sort values of GET /developer/v1/games
sort | Orders by |
|---|---|
ccu | Players now (the default) |
growth_1h | Growth of players over the last hour |
growth_6h | Growth over the last 6 hours |
growth_24h | Growth over the last 24 hours |
growth_7d | Growth over the last 7 days |
growth_daily | Growth of the daily mean of players, day on day |
visits_24h | Visits gained in the last 24 hours |
favorites_24h | Favorites gained in the last 24 hours |
like_ratio | Upvotes as a share of all votes |
visits | All-time visits |
newest | When the game was created on Roblox |
breakout | The breakout score, 0 to 100 |
velocity | Players gained per hour over the last three complete hours |
What GET /developer/v1/games answers
200 with a GamePage:
{ "items": [ { "id": 1002, "rootPlaceId": 2002, "name": "Steady Giant", "iconUrl": "https://tr.rbxcdn.com/…/512/512/Image/Webp/noFilter", "creator": { "type": "Group", "id": 3002, "name": "Giant Studio", "hasVerifiedBadge": true }, "genreL1": "Simulation", "genreL2": "Incremental Simulator", "tier": "active", "ccu": 120000, "visits": 950000000, "favorites": 2100000, "likeRatio": 0.91, "createdAt": "2021-03-04T10:00:00.000Z", "lastSnapshotAt": "2026-10-24T09:55:00.000Z", "growth1h": 0, "growth6h": 0.04, "growth24h": -0.02, "growth7d": 0.01, "growthDaily": 0.005, "visits24h": 1800000, "favorites24h": 2400, "velocity": 150, "acceleration": -20, "risingHours": 3, "volatility": 0.08, "peakRatio": 0.62, "breakout": 12 }, { "id": 1001, "name": "Rising Tycoon", "ccu": 6000, "growth1h": 0.5, "...": "GameSummary" } ], "total": 2, "limit": 100, "offset": 0}GamePage
itemsGameSummary[]- The page's games, in the order asked.
totalnumber- How many games match the filters, across every page.
limitnumber- The page size used.
offsetnumber- How many matching games were skipped.
Paging through every matching game
Ask with limit=100 and offset=0, then offset=100, 200 and so on while offset is below
total. Each page is its own request and its own cache entry, so page only when you need the
whole list; for a fixed set of games use ids instead. A game can move between pages while you
page, because the order is by live numbers.
Only games read at least once (lastSnapshotAt set) are ever listed.
Every GameSummary field
Growth values are ratios: 0.5 is +50%. null means unknown (not enough history yet, or never read), never zero. Times are ISO 8601 in UTC.
GameSummary
idnumber- The Roblox universe id: the game's id everywhere on the platform.
rootPlaceIdnumber | null- The start place, for a link to the game on Roblox.
namestring | null- As of the last reading.
iconUrlstring | null- The game's icon on Roblox's image CDN.
creatorobject | nulltype(UserorGroup),id,name(or null) andhasVerifiedBadge.genreL1string | null- Roblox's first-level genre.
genreL2string | null- Roblox's second-level genre (subgenre).
tierstring- How often the collector reads the game:
hotevery 5 minutes,active15 minutes,warman hour,colda day,deada week. ccunumber | null- Players in the game at the last reading (concurrent users).
visitsnumber | null- All-time visits at the last reading.
favoritesnumber | null- Favorites at the last reading. Roblox reports a negative count for some games, and it is passed on as reported.
likeRationumber | null- Upvotes as a share of all votes, 0 to 1.
createdAtstring | null- When the game was created on Roblox.
lastSnapshotAtstring | null- When the platform last read the game: the time
ccu,visitsandfavoritesare from. growth1hnumber | null- Growth of players against an hour ago.
growth6hnumber | null- Growth against 6 hours ago.
growth24hnumber | null- Growth against 24 hours ago.
growth7dnumber | null- Growth against 7 days ago.
growthDailynumber | null- Growth of the mean players over the last day against the day before; not distorted by the time of day.
visits24hnumber | null- Visits gained in the last day.
favorites24hnumber | null- Favorites gained in the last day.
velocitynumber | null- Players gained per hour over the last three complete hours.
accelerationnumber | null- How the velocity changed against the three hours before.
risingHoursnumber | null- Of the last six hours, how many ended above the hour before, 0 to 6.
volatilitynumber | null- Spread of the hourly means over the last day, as a share of their average.
peakRationumber | null- Players now over the all-time peak, 0 to 1.
breakoutnumber | null- How strongly the game is breaking out now, 0 to 100; null until there is enough history.
The growth figures, velocity and the breakout score are recomputed every 5 minutes. How the score is made: Radar and Discovery.
How GET /developer/v1/games is cached
Answers come from the platform's read cache, fresh for 60 seconds and replaced as soon as the collector stores new market data. Answers carry ETag and X-Cache (hit, stale, miss, shared or bypass). Send If-None-Match with the last ETag to get 304 with no body when nothing changed.
Errors from GET /developer/v1/games
| Status | error.code | When |
|---|---|---|
| 400 | validation_failed | A bad parameter: ids not comma-separated whole numbers or more than 100, an unknown sort, limit out of range. error.issues names it |
| 401 | unauthenticated | The key is missing, malformed, wrong or revoked, or its game left the catalog |
| 414 | uri_too_long | The address with its query is over 2,048 characters |
| 429 | rate_limited | Over a limit; wait the Retry-After seconds |
Bodies and what to do: Errors, limits and polling.
Updated