API reference · Charts

List a game’s places on the charts

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

Every place a game holds on Roblox’s charts right now, worldwide and in each of 60 countries, like JP-Up-and-Coming #4, with its place yesterday. Then each chart in sum: its place worldwide, its best, its days on it, and the countries where it’s on it, in the top 10 and #1. Name a chart to get its place there over time too.

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.
chartstring: Only one chart, like up-and-coming (or jp-up-and-coming for one country’s). With it, history has the game’s place on that chart over time: by the hour for its first 3 days, then once a day for 30 days.
countrystring: A country, as two letters like JP, BR or US (or its name, like Japan). Worldwide without it. List Roblox’s charts lists all 60.
devicestring: One device’s chart. phone and tablet are Roblox’s Standard Phone and Tablet; entry_phone and entry_tablet its Entry-level ones.allcomputerphoneentry_phonetabletentry_tabletconsolevrDefault all

Example

curl https://roterminal.co/api/v1/games/7436755782/charts \
  -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.charts('grow a garden')

from roterminal import RoTerminal

rt = RoTerminal()  # reads ROTERMINAL_API_KEY

data = rt.games.charts("grow a garden")["data"]

Response

{
  "data": {
    "id": 7436755782,
    "name": "Grow a Garden",
    "link": "https://roterminal.co/g/7436755782",
    "device": "all",
    "places_now": 97,
    "places": [
      {
        "label": "Top Earning",
        "slug": "top-earning",
        "chart": "Top Earning",
        "chart_id": "top-earning",
        "country_name": "Worldwide",
        "place": 57,
        "yesterday": 57,
        "move": 0,
        "link": "https://roterminal.co/charts/top-earning?game=7436755782"
      },
      {
        "label": "ZA-Top Earning",
        "slug": "za-top-earning",
        "chart": "Top Earning",
        "chart_id": "top-earning",
        "country": "ZA",
        "country_name": "South Africa",
        "place": 15,
        "yesterday": 14,
        "move": -1,
        "link": "https://roterminal.co/charts/top-earning?c=za&game=7436755782"
      },
      {
        "label": "GT-Top Earning",
        "slug": "gt-top-earning",
        "chart": "Top Earning",
        "chart_id": "top-earning",
        "country": "GT",
        "country_name": "Guatemala",
        "place": 25,
        "yesterday": 25,
        "move": 0,
        "link": "https://roterminal.co/charts/top-earning?c=gt&game=7436755782"
      },
      …
    ],
    "by_chart": [
      {
        "chart": "Top Earning",
        "chart_id": "top-earning",
        "place_worldwide": 57,
        "yesterday_worldwide": 57,
        "best_place_worldwide": 57,
        "days_on_it_worldwide": 12,
        "countries_on_it": 43,
        "top_10_in_countries": 0
      },
      {
        "chart": "Trending in Simulation",
        "chart_id": "top-trending",
        "genre": "Simulation",
        "place_worldwide": 67,
        "yesterday_worldwide": 63,
        "countries_on_it": 8,
        "top_10_in_countries": 0
      },
      {
        "chart": "Most Popular",
        "chart_id": "most-popular",
        "place_worldwide": 96,
        "yesterday_worldwide": 90,
        "best_place_worldwide": 71,
        "days_on_it_worldwide": 12,
        "countries_on_it": 19,
        "top_10_in_countries": 0
      },
      …
    ]
  },
  "link": "https://roterminal.co/g/7436755782",
  "as_of": "2026-10-22T13:39: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.

devicestring

Which device’s chart: all, computer, phone, entry_phone, tablet, entry_tablet, console or vr.

places_nowinteger

How many places it holds on the charts right now.

placeslist of object

Every place it holds now: by chart, worldwide first, then each country from its best place.

12 fields

labelstring: The chart and its country in short, like JP-Up-and-Coming (Japan’s Up-and-Coming). Worldwide, the chart’s name alone.
slugstring: The same as an ID, like jp-up-and-coming: Retrieve a chart takes it back as chart.
chartstring: The chart’s name.
chart_idstring: The chart’s ID, like up-and-coming.
genrestring: Its genre on Roblox.
countrystring: Its country as two letters, like JP. Left out worldwide.
country_namestring: Its country’s name, or Worldwide.
placeinteger: Its place on the list, 1 being the top.
yesterdayinteger: Its place on the chart this time yesterday. Left out when it wasn’t on it (new_today) or RoTerminal wasn’t reading it yet.
moveinteger: Places it climbed since yesterday: 3 is up three, -2 down two.
new_todayboolean: True when it wasn’t on the chart this time yesterday.
linkuri: Its page on roterminal.co.

by_chartlist of object

Each chart it’s on, in sum.

10 fields

chartstring: The chart’s name.
chart_idstring: The chart’s ID.
genrestring: Its genre on Roblox.
place_worldwideinteger: Its place on the worldwide chart now. Left out when it isn’t on it.
yesterday_worldwideinteger: Its place on the worldwide chart this time yesterday.
best_place_worldwideinteger: Its best place on the worldwide chart since RoTerminal began keeping it.
days_on_it_worldwideinteger: Days on the worldwide chart since RoTerminal began keeping it.
countries_on_itinteger: Countries whose chart it’s on now.
top_10_in_countriesinteger: Countries where it’s in this chart’s top 10.
number_one_inlist of strings: Countries where it’s first on that chart.

historyobject

With chart: its place on that chart over time, by the hour for the chart’s first 3 days, then once a day for 30 days.

2 fields

labelstring

The chart and its country in short, like JP-Up-and-Coming (Japan’s Up-and-Coming). Worldwide, the chart’s name alone.

pointslist of object

Oldest first.

2 fields

atdate-time: When it happened (New York time, ISO 8601).
placeinteger or null: Its place then. Null when it was off the chart.

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.