API reference · Lists
List the most played games
GET
/api/v1/games/topRoblox games ranked by players right now, or only the games that came out in the last 30 days. Optionally one genre.
Parameters
liststringmost_playedranks every game.newranks games that came out in the last 30 days.genrestring- Only one genre or subgenre, like
Simulation,TycoonorTower Defense. limitinteger- How many to return.
Example
curl "https://roterminal.co/api/v1/games/top?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.top({ limit: 5 })from roterminal import RoTerminal
rt = RoTerminal() # reads ROTERMINAL_API_KEY
data = rt.games.top(limit=5)["data"]Response
{
"data": {
"list": "The most played games right now",
"as_of": "2026-10-23T23:02:00-04:00",
"link": "https://roterminal.co/games",
"games": [
{
"place": 1,
"id": 10563114921,
"name": "Steal An Egg",
"developer": "and Collect Rare Pets",
"genre": "Simulation",
"playing_now": 1250305,
"change_24h": 47.4,
"high_last_24h": 1640150,
"link": "https://roterminal.co/g/10563114921",
"spark": [860151, 943402, 1030095, 1064062, 1107602, 1165846, 1177460, 1216826, …]
},
{
"place": 2,
"id": 66654135,
"name": "Murder Mystery 2",
"developer": "Nikilis",
"genre": "Survival",
"playing_now": 1181430,
"change_24h": 85.8,
"high_last_24h": 1223250,
"link": "https://roterminal.co/g/66654135",
"spark": [637102, 622300, 607845, 628473, 655496, 682669, 696517, 714359, …]
},
{
"place": 3,
"id": 1686885941,
"name": "Brookhaven RP",
"developer": "Brookhaven by Voldex",
"genre": "Roleplay & Avatar Sim",
"playing_now": 461326,
"change_24h": 79.6,
"high_last_24h": 675033,
"link": "https://roterminal.co/g/1686885941",
"spark": [260190, 243331, 235767, 229499, 226722, 233577, 244255, 255713, …]
},
…
]
},
"link": "https://roterminal.co/games",
"as_of": "2026-10-23T23:02:00-04:00"
}Fields
The fields in data. A field with nothing to say is left out.
liststring- Which list this is.
as_ofdate-time- When these numbers were read (New York time, ISO 8601).
linkuri- Its page on roterminal.co.
gameslist of object- The games, in order.
11 fields
placeinteger- Its place on the list, 1 being the top.
idinteger- The game’s universe ID on Roblox.
namestring- Its name, as Roblox shows it.
developerstring- Who makes it, as Roblox shows it.
genrestring- Its genre on Roblox.
playing_nowinteger- Players in it right now.
change_24hnumber- Players now against the same time a day ago, in percent.
high_last_24hinteger- Most players at once in the last 24 hours.
linkuri- Its page on roterminal.co.
sparklist of integers- Its players over the last day, oldest first, as evenly spaced readings, for a small chart.
came_outdate- The day it came out on Roblox.