API reference · Games
Retrieve a game
GET
/api/v1/games/{game}Everything on one Roblox game right now: players and its rank, the change over an hour and a day, highs, momentum, its genre, its developer, recent updates and how players moved after each, its closest rivals, its places on Roblox’s charts and the last 7 days of players.
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.
Example
curl https://roterminal.co/api/v1/games/7436755782 \
-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.retrieve('grow a garden')from roterminal import RoTerminal
rt = RoTerminal() # reads ROTERMINAL_API_KEY
data = rt.games.retrieve("grow a garden")["data"]Response
{
"data": {
"id": 7436755782,
"name": "Grow a Garden",
"link": "https://roterminal.co/g/7436755782",
"as_of": "2026-10-22T07:15:00-04:00",
"genre": "Simulation",
"developer": "The Garden Game",
"playing_now": 18200,
"place_on_roblox_by_players": {
"rank": 63,
"of": 32985
},
"share_of_everyone_on_roblox": 0.16,
"change_1h": 6.4,
"change_24h": -8.83,
"high_last_24h": 34789,
"high_last_14_days": {
"players": 34789,
"at": "2026-10-21T18:27:00-04:00"
},
"high_since_tracking_began": {
"players": 107663,
"at": "2026-10-03T16:30:00-04:00"
},
"momentum": {
"stage": "Steady",
"average_last_7_days": 20547,
"against_the_7_days_before": 7.57
},
"genre_place": {
"rank": 28,
"of": 262
},
"visits": 35983673688,
"visits_a_day": 1260842,
"favorites": 11453711,
"likes": 89.9,
"votes": 10494341,
"average_visit_minutes": 20,
"server_size": 4,
"busiest_hour_new_york": "1 PM",
"came_out": "2025-03-25",
"days_old": 575,
"last_updated": "2026-10-21T18:45:00-04:00",
"studio": {
"name": "The Garden Game",
"kind": "Roblox group",
"verified": false,
"members": 19479200,
"games": 1,
"players_in_all_their_games_now": 18200,
"place_among_developers": {
"rank": 235,
"of": null
},
"owner": "DevNamedDavid",
"link": "https://roterminal.co/studio/p7627847305-devnameddavid"
},
"updates": [
{
"at": "2026-10-21T18:45:00-04:00",
"title": "New version published",
"players_after_update": 2.29,
"measured_over_hours": 13
},
{
"at": "2026-10-19T21:28:00-04:00",
"title": "New version published",
"players_after_update": 8.89,
"measured_over_hours": 24
},
{
"at": "2026-10-19T17:55:00-04:00",
"title": "New version published",
"players_after_update": 13.5,
"measured_over_hours": 4
},
…
],
"events": [
{
"at": "2026-10-06T01:01:00-04:00",
"what": "Doubled in 6 hours",
"kind": "milestone"
},
{
"at": "2026-09-28T07:56:00-04:00",
"what": "Passed 25K players",
"kind": "milestone"
}
],
"roblox_charts_now": [
{
"chart": "Top Earning",
"place": 57,
"best_place": 57,
"days_on_it": 12,
"link": "https://roterminal.co/charts/top-earning?game=7436755782"
},
{
"chart": "Most Popular",
"place": 96,
"best_place": 71,
"days_on_it": 12,
"link": "https://roterminal.co/charts/top-earning?game=7436755782"
}
],
"all_of_roblox": {
"playing_now": 11190222,
"change_24h": 1.05,
"change_on_a_week_ago": 6.25
},
"rivals_in_genre": [
{
"id": 10765298801,
"name": "+1 Stone Skipping",
"playing_now": 18991,
"change_24h": -13.6,
"link": "https://roterminal.co/g/10765298801"
},
{
"id": 7089588429,
"name": "Drag Drive Simulator",
"playing_now": 18727,
"change_24h": 0.78,
"link": "https://roterminal.co/g/7089588429"
},
{
"id": 10769464063,
"name": "+1 Venom Evolution",
"playing_now": 18042,
"change_24h": -1.3,
"link": "https://roterminal.co/g/10769464063"
}
],
"spark_7d": [19989, 15753, 12931, 14897, 17334, 17293, 21352, 17819, …]
},
"link": "https://roterminal.co/g/7436755782",
"as_of": "2026-10-22T07:15: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.
as_ofdate-time- When these numbers were read (New York time, ISO 8601).
genrestring- Its genre on Roblox.
developerstring- Who makes it, as Roblox shows it.
playing_nowinteger- Players in it right now.
place_on_roblox_by_playersobject- Its rank among every game RoTerminal tracks, by players right now.
2 fields
rankinteger- Its place, 1 being the top.
ofinteger or null- Out of how many. Null when that isn’t known.
share_of_everyone_on_robloxnumber- Its share of everyone playing Roblox right now, in percent.
change_1hnumber- Players now against an hour ago, in percent.
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.
high_last_14_daysobject- Most players at once in the last 14 days, and when.
2 fields
playersinteger- Players at that moment.
atdate-time- When it happened (New York time, ISO 8601).
high_since_tracking_beganobject- Most players at once since RoTerminal began counting on Sep 27, 2026, and when.
2 fields
playersinteger- Players at that moment.
atdate-time- When it happened (New York time, ISO 8601).
momentumobject- How its last 7 days compare with the 7 days before.
3 fields
stagestring- Its direction: Spiking, Breaking out, Growing, Steady, Falling slightly or Declining.
average_last_7_daysinteger- Its average players over the last 7 days.
against_the_7_days_beforenumber- That average against the 7 days before, in percent.
genre_placeobject- Its rank among the live games in its genre, by players right now.
2 fields
rankinteger- Its place, 1 being the top.
ofinteger or null- Out of how many. Null when that isn’t known.
visitsinteger- Roblox’s running count of its visits.
visits_a_dayinteger- Visits in the last 24 hours.
favoritesinteger- Accounts that have it as a favorite.
likesnumber- Its share of thumbs up, in percent.
votesinteger- Thumbs up and thumbs down together.
average_visit_minutesinteger- About how long a visit lasts, in minutes.
server_sizeinteger- The most players one server holds.
busiest_hour_new_yorkstring- The hour it usually has the most players, New York time.
came_outdate- The day it came out on Roblox.
days_oldinteger- Days since it came out.
last_updateddate-time- When its developer last published a new version.
studioobject- Who makes it.
9 fields
namestring- Its name, as Roblox shows it.
kindstring- A Roblox group, or one person.
verifiedboolean- Whether Roblox shows it as verified.
membersinteger- Members of its Roblox group.
gamesinteger- How many games it has.
players_in_all_their_games_nowinteger- Everyone playing its games right now.
place_among_developersobject- Its rank among developers, by everyone playing their games right now.
2 fields
rankinteger- Its place, 1 being the top.
ofinteger or null- Out of how many. Null when that isn’t known.
ownerstring- Who owns it on Roblox.
linkuri- Its page on roterminal.co.
updateslist of object- Its latest updates, newest first.
4 fields
atdate-time- When it happened (New York time, ISO 8601).
titlestring- What it was.
players_after_updatenumber- Players in the hours after the update against the same hours a week before, in percent. Null while it’s still being measured.
measured_over_hoursinteger- How many hours after the update that was measured over (up to 24, or until the next update).
eventslist of object- Notable moments, like passing a number of players, newest first.
3 fields
atdate-time- When it happened (New York time, ISO 8601).
whatstring- What happened.
kindstring- What kind of moment it was, like a milestone.
roblox_charts_nowlist of object- Its places on Roblox’s own charts right now.
7 fields
chartstring- The chart’s name.
placeinteger- Its place on the list, 1 being the top.
best_placeinteger- Its best place on that chart since RoTerminal began keeping it.
days_on_itinteger- Days it’s been on that chart.
top_10_in_countriesinteger- Countries where it’s in this chart’s top 10.
linkuri- Its page on roterminal.co.
number_one_inlist of strings- Countries where it’s first on that chart.
all_of_robloxobject- Everyone playing Roblox, to compare with.
3 fields
playing_nowinteger- Players in it right now.
change_24hnumber- Players now against the same time a day ago, in percent.
change_on_a_week_agonumber- Against the same time a week ago, in percent.
rivals_in_genrelist of object- The games closest to it in its genre, by players.
5 fields
idinteger- The game’s universe ID on Roblox.
namestring- Its name, as Roblox shows it.
playing_nowinteger- Players in it right now.
change_24hnumber- Players now against the same time a day ago, in percent.
linkuri- Its page on roterminal.co.
spark_7dlist of integers- Its players over the last 7 days, oldest first: 42 evenly spaced readings, for a small chart.
new_players_a_dayinteger- About how many people played it for the first time in the last day. An estimate.
played_by_accountsinteger- About how many accounts have ever played it. An estimate.
storeobject- What it sells: its game passes and their prices in Robux.
4 fields
passesinteger- How many game passes it sells.
cheapest_robuxinteger- Its cheapest game pass, in Robux.
priciest_robuxinteger- Its priciest game pass, in Robux.
typical_robuxinteger- The middle price of its game passes, in Robux.
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.