GET /developer/v1/games

Reference for listing tracked games or reading up to 100 games by id - every parameter, the sort values, and every GameSummary field.

Endpoints / Market data / List games

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

AuthorizationstringRequired
Bearer bk_live_<the game's key>.
If-None-Matchstring
The ETag of the last answer; an unchanged answer is then 304 with 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.
dirstring
desc (default) or asc. 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 as Simulation.
tierstring
hot, active, warm, cold or dead. Without it, dead games are left out, unless ids is 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 ids is given without a limit.
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.

HTTP
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

sortOrders by
ccuPlayers now (the default)
growth_1hGrowth of players over the last hour
growth_6hGrowth over the last 6 hours
growth_24hGrowth over the last 24 hours
growth_7dGrowth over the last 7 days
growth_dailyGrowth of the daily mean of players, day on day
visits_24hVisits gained in the last 24 hours
favorites_24hFavorites gained in the last 24 hours
like_ratioUpvotes as a share of all votes
visitsAll-time visits
newestWhen the game was created on Roblox
breakoutThe breakout score, 0 to 100
velocityPlayers gained per hour over the last three complete hours

What GET /developer/v1/games answers

200 with a GamePage:

JSON
{  "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 | null
type (User or Group), id, name (or null) and hasVerifiedBadge.
genreL1string | null
Roblox's first-level genre.
genreL2string | null
Roblox's second-level genre (subgenre).
tierstring
How often the collector reads the game: hot every 5 minutes, active 15 minutes, warm an hour, cold a day, dead a 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, visits and favorites are 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

Statuserror.codeWhen
400validation_failedA bad parameter: ids not comma-separated whole numbers or more than 100, an unknown sort, limit out of range. error.issues names it
401unauthenticatedThe key is missing, malformed, wrong or revoked, or its game left the catalog
414uri_too_longThe address with its query is over 2,048 characters
429rate_limitedOver a limit; wait the Retry-After seconds

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

Updated