GET /developer/v1/genres

Reference for the list of Roblox first-level genres with how many tracked games each holds and how many players are in them now.

Endpoints / Market data / Genres

Answers each first-level genre the platform's tracked games are filed under, with how many of them there are and their players now, most players first.

Request to GET /developer/v1/genres

GET/developer/v1/genres

Headers

AuthorizationstringRequired
Bearer bk_live_<the game's key>.

The route takes no parameters.

HTTP
GET https://studio.blockoutgames.com/developer/v1/genresAuthorization: Bearer bk_live_<the game's key>

What GET /developer/v1/genres answers

200 with a list, most players first:

JSON
[  { "genre": "Simulation", "games": 4210, "ccu": 2300000 },  { "genre": "Roleplay & Avatar Sim", "games": 2875, "ccu": 1900000 },  { "genre": "Action", "games": 1990, "ccu": 640000 }]

GenreSummary

genrestring
The first-level genre, as Roblox files it (a game's genreL1).
gamesnumber
How many tracked games are in it: read at least once and not dead.
ccunumber
Those games' players at their last readings, added up.

Games without a genre are not counted. Use a genre value as the genre filter of GET /developer/v1/games.

How GET /developer/v1/genres is cached

From the platform's read cache, fresh for 60 seconds and replaced when the collector stores new market data. The Template's PlatformService.genres() keeps an answer for 300 seconds.

Errors from GET /developer/v1/genres

Statuserror.codeWhen
401unauthenticatedThe key is missing, malformed, wrong or revoked, or its game left the catalog
429rate_limitedOver a limit; wait the Retry-After seconds

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

Updated