API reference · Charts

Retrieve a chart

GET/api/v1/charts/{chart}

One of Roblox’s charts now, worldwide or in one country, on all devices or one: its games in order, each with its players, its place yesterday and a week ago, its move, its best place and its days on the chart. Put a country in front of the chart for that country’s chart: jp-up-and-coming is Japan’s Up-and-Coming.

Parameters

chartstringRequiredPath: The chart’s ID, like top-earning, top-trending or up-and-coming, or a genre’s Trending list, like trending-in-rpg. A country in front picks that country’s chart: jp-up-and-coming. List them with List Roblox’s charts.
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
genrestring: For top-trending: one genre’s Trending list, like RPG or Simulation.
limitinteger: How many games, from the top. A chart has up to 100.Default 10 · 1 to 100

Example

curl "https://roterminal.co/api/v1/charts/jp-up-and-coming?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.charts.retrieve('jp-up-and-coming', { limit: 5 })

from roterminal import RoTerminal

rt = RoTerminal()  # reads ROTERMINAL_API_KEY

data = rt.charts.retrieve("jp-up-and-coming", limit=5)["data"]

Response

{
  "data": {
    "chart": "Up-and-Coming",
    "chart_id": "up-and-coming",
    "label": "JP-Up-and-Coming",
    "slug": "jp-up-and-coming",
    "what_it_ranks": "Top experiences published within the last 28 days sorted by user growth.",
    "where": "Japan, All Devices",
    "country": "JP",
    "device": "all",
    "read_at": "2026-10-24T03:03:00-04:00",
    "kept_since": "2026-10-10",
    "games_on_it": 94,
    "link": "https://roterminal.co/charts/up-and-coming?c=jp",
    "games": [
      {
        "place": 1,
        "id": 10770728771,
        "name": "The Hollow",
        "developer": "Roblox Presents",
        "genre": "Entertainment",
        "playing_now": 36864,
        "yesterday": 1,
        "move": 0,
        "best_place": 1,
        "days_on_chart": 3,
        "link": "https://roterminal.co/g/10770728771"
      },
      {
        "place": 2,
        "id": 10769454450,
        "name": "Lava Rising Tower",
        "developer": "Obby rn",
        "genre": "Obby & Platformer",
        "playing_now": 641,
        "yesterday": 12,
        "move": 10,
        "best_place": 2,
        "days_on_chart": 7,
        "link": "https://roterminal.co/g/10769454450"
      },
      {
        "place": 3,
        "id": 10770605947,
        "name": "Ragdoll Reality",
        "developer": "I am eating",
        "genre": "Simulation",
        "playing_now": 42320,
        "yesterday": 58,
        "move": 55,
        "best_place": 3,
        "days_on_chart": 3,
        "link": "https://roterminal.co/g/10770605947"
      },
      …
    ]
  },
  "link": "https://roterminal.co/charts/up-and-coming?c=jp",
  "as_of": "2026-10-24T03:38:00-04:00"
}

Fields

The fields in data. A field with nothing to say is left out.

chartstring

The chart’s name.

chart_idstring

The chart’s ID, like up-and-coming.

genrestring

Its genre on Roblox.

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.

what_it_ranksstring

What Roblox says the chart ranks.

wherestring

Which countries and devices the chart is for.

countrystring

Its country as two letters, like JP. Left out worldwide.

devicestring

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

same_everywhereboolean

True for a chart that’s the same in every country and on every device (Top Rated, Top Paid Access, Top Playing Now).

read_atdate-time

When RoTerminal last read this chart from Roblox (it reads each one about once an hour).

kept_sincedate

The first day RoTerminal kept this chart. Best places and days on the chart count from then.

games_on_itinteger

How many games the chart has now.

linkuri

Its page on roterminal.co.

gameslist of object

The games, in order.

14 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.
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.
last_weekinteger: Its place this time a week ago, when it was on the chart.
best_placeinteger: Its best place on that chart since RoTerminal began keeping it.
days_on_chartinteger: Days it’s been on the chart since RoTerminal began keeping it.
top_10_in_countriesinteger: Countries where it’s in this chart’s top 10.
linkuri: Its page on roterminal.co.