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
AuthorizationstringRequiredBearer bk_live_<the game's key>.
The route takes no parameters.
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:
[ { "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
| Status | error.code | When |
|---|---|---|
| 401 | unauthenticated | The key is missing, malformed, wrong or revoked, or its game left the catalog |
| 429 | rate_limited | Over a limit; wait the Retry-After seconds |
Bodies and what to do: Errors, limits and polling.
Updated