Answers a tracked game's players, visits, favorites and votes over a range, in buckets of a fixed width, oldest first. It answers what the panel's players chart on a game's page reads.
Request to GET /developer/v1/games/:id/history
GET/developer/v1/games/:id/history
Path
idnumberRequired- The game's Roblox universe id.
Query
rangestring6h,24h(default),7d,30dorall.
GET https://studio.blockoutgames.com/developer/v1/games/1001/history?range=24hAuthorization: Bearer bk_live_<the game's key>The history ranges and their bucket widths
range | Covers | bucketSeconds | Bucket |
|---|---|---|---|
6h | The last 6 hours | 300 | 5 minutes |
24h | The last 24 hours | 300 | 5 minutes |
7d | The last 7 days | 1800 | 30 minutes |
30d | The last 30 days | 7200 | 2 hours |
all | Since tracking began | 86400 | 1 day |
A bucket holds the readings taken in it. A game read less often than the bucket width (a cold game, read once a day) has buckets only where it was read.
What GET /developer/v1/games/:id/history answers: history points
200 with a GameHistory:
{ "range": "24h", "bucketSeconds": 300, "points": [ { "t": "2026-10-23T10:00:00Z", "ccu": 1520, "ccuMax": 1544, "visits": 990000, "favorites": 36000, "upVotes": 7100, "downVotes": 1000 }, { "t": "2026-10-23T10:05:00Z", "ccu": 1610, "ccuMax": 1610, "visits": 991200, "favorites": 36050, "upVotes": null, "downVotes": null } ]}HistoryPoint
tstring- The bucket's start, UTC, as
YYYY-MM-DDTHH:MM:SSZ. ccunumber- Mean players over the bucket's readings, rounded.
ccuMaxnumber- The most players in one reading in the bucket.
visitsnumber- All-time visits at the bucket's last reading (a running total).
favoritesnumber- Favorites at the bucket's last reading.
upVotesnumber | null- Upvotes at the bucket's last reading; null when votes could not be read then.
downVotesnumber | null- Downvotes at the bucket's last reading; null when votes could not be read then.
points is empty when the game has no readings in the range. A game the platform does not track is 404.
How GET /developer/v1/games/:id/history 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.history(id, range) keeps an answer for 300 seconds.
Errors from GET /developer/v1/games/:id/history
| Status | error.code | When |
|---|---|---|
| 400 | validation_failed | A bad id, or a range that is not one of the five |
| 401 | unauthenticated | The key is missing, malformed, wrong or revoked, or its game left the catalog |
| 404 | not_found | The platform does not track that game |
| 429 | rate_limited | Over a limit; wait the Retry-After seconds |
Bodies and what to do: Errors, limits and polling.
Updated