Roblox API: List top games
Lists ranked Roblox experiences from a current Charts list. Each game includes players online, approval percentage, creator, icon and game link.
Unofficial. Not affiliated with or endorsed by Roblox.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Chart optional
chart The Roblox chart to list, for example most_popular.
top_rated
One of
most_popular,top_trending,top_earning,top_rated,up_and_coming. Defaultmost_popular.- Max Results optional
max_results Maximum games to return, for example 50 (up to 100).
100
Whole number from 1 to 100. Default
50.
Input as JSON
{ "chart": "top_rated", "max_results": 100}Output
{ "games": [ { "name": "Chicken Farm 🐣", "rank": 1, "roblox_link": "https://www.roblox.com/games/137233438285284/Chicken-Farm" , "universe_id": 10209534490, "creator_name": "Skandi Studios", "icon_image_link": "https://tr.rbxcdn.com/180DAY-fb0455d36bd1cd15f946c57abb8f2c6d/150/150/Image/Png/noFilter" , "like_percentage": 99, "players_online_now": 2450 }, { "name": "[🦇VAMPIRE🐎] Basketball: Zero", "rank": 2, "roblox_link": "https://www.roblox.com/games/130739873848552/Basketball-Zero" , "universe_id": 7028566528, "creator_name": "Current.", "icon_image_link": "https://tr.rbxcdn.com/180DAY-a5c4e29e3ca8b038a119756a07411d56/150/150/Image/Png/noFilter" , "like_percentage": 98.3, "players_online_now": 6115 }, { "name": "[🎃] Anime Dice", "rank": 3, "roblox_link": "https://www.roblox.com/games/113290951185459/Anime-Dice" , "universe_id": 10708913337, "creator_name": "More & More Games", "icon_image_link": "https://tr.rbxcdn.com/180DAY-6eadd1cbe12feeb513bb90ce46070a07/150/150/Image/Png/noFilter" , "like_percentage": 99.1, "players_online_now": 71878 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"roblox.com/list_top_games","input":{"chart":"top_rated","max_results":100}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "roblox.com/list_top_games" , "input": { "chart": "top_rated", "max_results": 100 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "roblox.com/list_top_games" , "input": { "chart": "top_rated", "max_results": 100 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run roblox.com/list_top_games# with {"chart":"top_rated","max_results":100}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "chart": { "enum": [ "most_popular", "top_trending", "top_earning", "top_rated", "up_and_coming" ], "type": "string", "default": "most_popular", "description": "The Roblox chart to list, for example most_popular." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Maximum games to return, for example 50 (up to 100)." } }}Output schema
{ "type": "object", "required": [ "games" ], "properties": { "games": { "type": "array", "items": { "type": "object", "required": [ "rank", "name", "roblox_link", "universe_id" ], "properties": { "name": { "type": "string" }, "rank": { "type": "integer" }, "roblox_link": { "type": "string" }, "universe_id": { "type": "integer" }, "creator_name": { "type": [ "string", "null" ] }, "icon_image_link": { "type": [ "string", "null" ] }, "like_percentage": { "type": [ "number", "null" ] }, "players_online_now": { "type": [ "integer", "null" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
roblox.com/list_top_games- Returns
- rank, name, creator, players online, like percentage, icon, link, universe id
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method roblox.com/list_top_games with the inputs above.
Ask your agent
- Show me the top 25 most popular games on Roblox right now with their player counts
- What are the highest earning Roblox experiences this week? Give me the top 10 with creators
- List the top rated games on roblox.com including like percentage and creator names
- Which up and coming Roblox games are charting currently? Show up to 40 with their links
- Give me the top trending experiences on Roblox with universe IDs and current players online
See more
All Roblox methodsGets a Roblox experience by name or game link, with players online, visits, likes, creator, dates, maturity rating and icon. For names with several matches, returns the match with the most players.
roblox.com/get_gameLists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
play.google.com/list_top_chartsLists the ranked Microsoft Store apps or games in a top chart, optionally for one category and country. Paid listings without a published numeric price return a null price.
apps.microsoft.com/list_top_chartsLists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.
apps.apple.com/list_top_chartsLists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.
imdb.com/list_top_chartsGets Shazam's current ranked top songs for the world, a country, or a city, optionally by genre. City charts have up to 50 songs; genres are available only in some places.
shazam.com/list_top_chartsLists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
music.apple.com/list_top_chartsLists current worldwide top tracks, albums or artists on Deezer in chart order, or tracks from Deezer's official Top <country> playlist.
deezer.com/list_top_charts