GET /developer/v1/games/:id/history

Reference for a tracked game's players over time - the ranges, the bucket widths, and every field of a history point.

Endpoints / Market data / A game’s players over time

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

rangestring
6h, 24h (default), 7d, 30d or all.
HTTP
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

rangeCoversbucketSecondsBucket
6hThe last 6 hours3005 minutes
24hThe last 24 hours3005 minutes
7dThe last 7 days180030 minutes
30dThe last 30 days72002 hours
allSince tracking began864001 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:

JSON
{  "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

Statuserror.codeWhen
400validation_failedA bad id, or a range that is not one of the five
401unauthenticatedThe key is missing, malformed, wrong or revoked, or its game left the catalog
404not_foundThe platform does not track that game
429rate_limitedOver a limit; wait the Retry-After seconds

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

Updated