API reference · Games

List a game’s days

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

A game’s players day by day, newest first: the average, peak and low, the visits that day, and what happened (updates and events). Days run midnight to midnight, New York time.

Pro: More than 7 days needs Pro or Studio. On Free and Plus the answer has the last 7 days and a locked object that says so. Each different game counts toward your plan’s history a day (see Rate limits).

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.
daysinteger: How many days back. Free and Plus return the last 7; Pro and Studio return every day since tracking began on Sep 27, 2026.Default 14 · 1 to 60

Example

curl "https://roterminal.co/api/v1/games/7436755782/days?days=7" \
  -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.days('grow a garden', { days: 7 })

from roterminal import RoTerminal

rt = RoTerminal()  # reads ROTERMINAL_API_KEY

data = rt.games.days("grow a garden", days=7)["data"]

Response

{
  "data": {
    "id": 7436755782,
    "name": "Grow a Garden",
    "link": "https://roterminal.co/g/7436755782",
    "days": [
      {
        "day": "2026-10-23",
        "average": 21285,
        "peak": 26470,
        "low": 17598,
        "visits_that_day": 1832112,
        "what_happened": "Update"
      },
      {
        "day": "2026-10-22",
        "average": 16999,
        "peak": 21020,
        "low": 13342,
        "visits_that_day": 1337593,
        "what_happened": "Update"
      },
      {
        "day": "2026-10-21",
        "average": 17908,
        "peak": 34789,
        "low": 14889,
        "visits_that_day": 1263141,
        "what_happened": "Watering Wednesday"
      },
      …
    ]
  },
  "link": "https://roterminal.co/g/7436755782",
  "as_of": "2026-10-23T23:03: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.

dayslist of object

One row a day, newest first. Days run midnight to midnight, New York time.

7 fields

daydate: The day (New York).
averageinteger: Average players that day, weighted by time.
peakinteger: Most players at once that day.
lowinteger: Fewest players at once that day.
visits_that_dayinteger: Visits that day.
partialboolean: True when RoTerminal counted only part of that day.
what_happenedstring: An update or event that day.