Developers
CCUCheck API
Read Roblox player counts, history, movers and charts from your own code, CLI or AI agent.
The CCUCheck API is a read-only HTTP API at https://ccucheck.com/api/v1. It returns the same numbers you see on CCUCheck: players right now, player history, visits, likes, favourites, the games gaining players and where games sit on Roblox's charts. Every number comes with the time it was read.
Your first call
No sign-up needed. This asks for Adopt Me! by its Roblox place id, the number in its Roblox link:
curl -A "my-app/1.0 ([email protected])" \
"https://ccucheck.com/api/v1/games/920587237"import https from "node:https";
https.get("https://ccucheck.com/api/v1/games/920587237", {
headers: { "User-Agent": "my-app/1.0 ([email protected])" },
}, (res) => {
let body = "";
res.on("data", (chunk) => (body += chunk));
res.on("end", () => {
const { data, as_of } = JSON.parse(body);
console.log(data, as_of);
});
});import requests
res = requests.get(
"https://ccucheck.com/api/v1/games/920587237",
headers={"User-Agent": "my-app/1.0 ([email protected])"},
timeout=10,
)
body = res.json()
print(body["data"], body["as_of"]){
"data": {
"place_id": "920587237",
"universe_id": "383310974",
"name": "Adopt Me!",
"creator": {
"name": "Uplift Games",
"type": "group"
},
"category": "Roleplay",
"players_now": 173922,
"visits": 41000000000,
"likes": 1000000,
"dislikes": 120000,
"likes_percent": 89.3,
"favourites": 25000000,
"all_time_peak": {
"players": 210000,
"on": "2026-07-05"
},
"tracked_since": "2026-02-21",
"history_from": "2026-02-21",
"found_early": null,
"created_on_roblox": "2017-06-29",
"updated_on_roblox": "2026-10-24T16:02:11.000Z",
"roblox_url": "https://www.roblox.com/games/920587237"
},
"link": "https://ccucheck.com/games/920587237",
"as_of": "2026-10-27T08:40:12.000Z"
}Response shape
Every successful answer has the same three fields, plus meta where an endpoint has extra context:
data: the result.link: the CCUCheck page for it, so you can link people to the full view.as_of: when the numbers were read, in UTC (ISO 8601).
Errors have one shape too: { error: { code, message, status, docs } }. See Errors and limits.
Plans and limits
| Who | Requests | Per minute | History | Keys |
|---|---|---|---|---|
| No key | 60 a hour | 20 | 30 days | None |
| Free key | 1,000 a day | 60 | 30 days | 3 |
| Pro key | 20,000 a day | 300 | Everything | 10 |
Unsigned calls are counted per IP address. Key calls are counted per account, so extra keys never add requests. History beyond 30 days, bigger allowances and more keys come with Pro.
Next steps
Get an API key
Free, from your account. Shown once.
Games
Search, one game, players now and tracked since.
Command line
npx ccucheck "Adopt Me" with JSON output for agents.
AI agents
Connect Claude, ChatGPT, Cursor or Codex over MCP.
OpenAPI 3.1: /api/v1/openapi.json. Plain text for AI tools: /llms.txt.