API reference

API reference

The RoTerminal API is read only and answers in JSON. Every endpoint takes GET.

Base URL
https://roterminal.co/api/v1

Requests

  • Send parameters in the address: https://roterminal.co/api/v1/games/rising?range=7d&limit=5.
  • A key is optional except for List your games. See Authentication.
  • Name a game by its universe ID, its name or its roterminal.co link. A name picks the most played game that matches, and Retrieve a game lists the others under did_you_mean.

Responses

Every response is an object with the same three fields:

FieldDescription
dataThe answer. Each endpoint’s page lists its fields.
linkThe page on roterminal.co with the same numbers. Link to it when you show them.
as_ofWhen the answer was made.
  • Numbers are numbers, never words.
  • Percents are in percent: 12.5 means 12.5%, and -3 means down 3%.
  • Ranks are { "rank": 57, "of": 33681 }, 1 being the top. of is null when it isn’t known.
  • Times are ISO 8601 in New York time, with the offset: 2026-10-20T11:41:00-04:00. Days are 2026-10-20, midnight to midnight in New York.
  • A field with nothing to say is left out, rather than sent as null or zero.
  • History starts on Sep 27, 2026, when RoTerminal began counting. A game RoTerminal found later starts then.

Pro: some answers have more on a bigger plan, like every day of a game’s history. On Free they come with the rest of the answer and a locked object that says what’s left out and on which plan.

Versioning

This is version 1. Within it, we only add: new endpoints, new parameters and new fields. We don’t rename or remove anything, so ignore fields you don’t know. A change that would break something comes as a new version, announced in the changelog first.

OpenAPI

The whole API as an OpenAPI 3.1 file, for Postman, code generators and AI tools:

OpenAPI
https://roterminal.co/api/v1/openapi.json

Endpoints

Games

Endpoint
Retrieve a gameGET /games/{game}
List a game’s daysGET /games/{game}/days
Get live playersGET /games/{game}/live
Retrieve a game’s developerGET /games/{game}/developer
Search gamesGET /games/search
Compare gamesGET /games/compare

Lists

Endpoint
List the most played gamesGET /games/top
List rising gamesGET /games/rising
Screen gamesGET /games/screen
Endpoint
List trendsGET /trends
Retrieve a trendGET /trends/{word}

Genres

Endpoint
List genresGET /genres

Charts

Endpoint
List Roblox’s chartsGET /charts
Retrieve a chartGET /charts/{chart}

Developers

Endpoint
Retrieve a developerGET /developers/{developer}

Roblox

Endpoint
Get players on RobloxGET /roblox

Account

Endpoint
Retrieve your accountGET /me
List your gamesGET /me/games