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-22T17:47: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": 811155,
"change_24h": 10.7,
"high_last_24h": 1397994,
"link": "https://roterminal.co/g/10563114921",
"spark": [738000, 778553, 760386, 749953, 766509, 767957, 743845, 791450, …]
},
{
"place": 2,
"id": 66654135,
"name": "Murder Mystery 2",
"developer": "Nikilis",
"genre": "Survival",
"playing_now": 672934,
"change_24h": 5.29,
"high_last_24h": 711800,
"link": "https://roterminal.co/g/66654135",
"spark": [633838, 641928, 675196, 673609, 671981, 665462, 615604, 602741, …]
},
{
"place": 3,
"id": 1686885941,
"name": "Brookhaven RP",
"developer": "Brookhaven by Voldex",
"genre": "Roleplay & Avatar Sim",
"playing_now": 316599,
"change_24h": 1.3,
"high_last_24h": 386940,
"link": "https://roterminal.co/g/1686885941",
"spark": [311796, 316249, 319247, 316248, 313306, 291135, 264940, 236487, …]
},
…
]
},
"link": "https://roterminal.co/games",
"as_of": "2026-10-22T17:47: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.