API reference · Games

List a game’s updates

GET/api/v1/games/{game}/updates

Every update of a game since tracking began on Sep 27, 2026, newest first: when it went out, its title, how many versions were published, and players in the hours after it against the same hours a week before. Also the typical change across its updates, to see which ones did better than usual.

Pro: More than the last 10 updates needs Pro or Studio. On Free and Plus the answer has the last 10 and a locked object that says so.

Parameters

gamestringRequiredPath: The game: its universe ID, its name (like grow a garden), its Roblox link or place ID, or its roterminal.co link. A name picks the most played match.
limitinteger: How many updates, newest first. Free and Plus return the last 10; Pro and Studio return every one.Default 10 · 1 to 50

Example

curl "https://roterminal.co/api/v1/games/7436755782/updates?limit=5" \
  -H "Authorization: Bearer $ROTERMINAL_API_KEY"

import RoTerminal from 'roterminal'

const rt = new RoTerminal({ apiKey: process.env.ROTERMINAL_API_KEY })

const { data } = await rt.games.updates('grow a garden', { limit: 5 })

from roterminal import RoTerminal

rt = RoTerminal()  # reads ROTERMINAL_API_KEY

data = rt.games.updates("grow a garden", limit=5)["data"]

Response

{
  "data": {
    "id": 7436755782,
    "name": "Grow a Garden",
    "link": "https://roterminal.co/g/7436755782",
    "updates_since_tracking_began": 32,
    "typical_change": 7.98,
    "updates": [
      {
        "at": "2026-10-21T18:45:00-04:00",
        "title": "New version published",
        "versions_published": 2,
        "players_before": 15660,
        "players_after": 16019,
        "change": 2.29,
        "measured_over_hours": 13
      },
      {
        "at": "2026-10-19T21:28:00-04:00",
        "title": "New version published",
        "versions_published": 1,
        "players_before": 16473,
        "players_after": 17938,
        "change": 8.89,
        "measured_over_hours": 24
      },
      {
        "at": "2026-10-19T17:55:00-04:00",
        "title": "New version published",
        "versions_published": 4,
        "players_before": 14637,
        "players_after": 16610,
        "change": 13.5,
        "measured_over_hours": 4
      },
      …
    ]
  },
  "link": "https://roterminal.co/g/7436755782",
  "as_of": "2026-10-22T07:16:00-04:00"
}

Fields

The fields in data. A field with nothing to say is left out.

idinteger

The game’s universe ID on Roblox.

namestring

Its name, as Roblox shows it.

linkuri

Its page on roterminal.co.

updates_since_tracking_beganinteger

Updates RoTerminal has seen since Sep 27, 2026.

typical_changenumber

The middle change across its measured updates, in percent: an update that beat it did better than usual.

updateslist of object

Its latest updates, newest first.

8 fields

atdate-time: When it happened (New York time, ISO 8601).
titlestring: What it was.
versions_publishedinteger: How many new versions went out together (a fix right after counts with it).
players_beforeinteger: Average players in the same hours a week before.
players_afterinteger: Average players in the hours after the update.
changenumber: Players after against before, in percent.
measured_over_hoursinteger: How many hours after the update that was measured over (up to 24, or until the next update).
measuringboolean: True while the update is too new to measure (its first hours).

did_you_meanlist of object

Other games that matched the name, when the match wasn’t exact.

3 fields

idinteger: The game’s universe ID on Roblox.
namestring: Its name, as Roblox shows it.
playing_nowinteger: Players in it right now.