API Documentation

Complete guide for developers integrating RBX Tracker into their applications

Authentication PREMIUM+

API access is available for Premium and Enterprise subscribers. You must first create an API key from the API Keys page.

Include API Key in Request Header

X-API-Key: rbx_your_api_key_here

Or Using Bearer Authentication

Authorization: Bearer rbx_your_api_key_here
Security Warning: Never expose your API keys in client-side code or public repositories. Keep them secure and rotate them regularly.

Rate Limits

API requests are subject to the following rate limits:

Rate limit information is included in response headers:

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 95 X-RateLimit-Reset: 1640995200

API Endpoints

Base URL

https://rbxstats.newstargeted.com/api/v1

GET /games

Get all games tracked by your account.

Response Example:
{ "success": true, "games": [ { "id": 1, "roblox_id": "123456789", "name": "My Awesome Game", "channel_id": "987654321", "is_active": true, "created_at": "2025-10-13T00:00:00.000Z" } ] }

GET /games/:id/stats

Get current statistics for a specific game (single snapshot from your tracked games).

Parameters:
  • id (required): Internal game ID
Response Example:
{ "success": true, "game": { "id": 1, "name": "My Awesome Game", "stats": { "visits": 1000000, "likes": 45000, "dislikes": 5000, "favorites": 50000, "playing": 1500 }, "lastUpdated": "2025-10-27T12:00:00.000Z" } }

GET /games/summary

Get game summaries with optional historical data for a date range (Premium/Enterprise).

Query parameters:
  • start_date (optional): YYYY-MM-DD
  • end_date (optional): YYYY-MM-DD
  • game_id (optional): Specific game ID or omit for all games

GET /games/:id/summary

Get summary for a specific game with optional historical data (Premium/Enterprise).

Query parameters:
  • start_date (optional): YYYY-MM-DD
  • end_date (optional): YYYY-MM-DD

GET /games/:id/export

Export raw time-series data for a game (Premium/Enterprise). Returns timestamp (UTC), universe_id, CCU, visits, favorites, likes, dislikes, revenue.

Query parameters:
  • start_date (required): YYYY-MM-DD
  • end_date (required): YYYY-MM-DD
  • format (optional): json (default) or csv
Example:
GET /api/v1/games/801672905/export?start_date=2025-01-01&end_date=2025-01-31&format=csv

GET /user

Get current API user info and subscription (plan, max games, trial status).

GET /usage

Get API usage limits and current usage (games count, rate limits, API keys).

Data, time-series & retention

Historical snapshots

Yes. We store time-series data per experience with timestamp (UTC), universe ID, CCU, visits, favorites, likes, and revenue when available.

Sampling resolution

Resolution is plan-based:

Retention by plan

Timestamps

All time-series and export timestamps are in UTC (ISO 8601).

Rank data

We track and store real rankings among your tracked games: by current players (CCU) and by total visits. Optionally, rankings can be enriched from an external source (e.g. Popular/Trending) when configured.

Where users see Rank: on the Game stats page (per-game rank card and rank-over-time chart), on the Summary page (current position and per-game rank in the date range), and in Discord via the /rank slash command.

Larger export

Yes. Via the web: summary view plus CSV, Excel, and JSON export. Via API: GET /api/v1/games/:id/export?start_date=...&end_date=...&format=csv|json (Premium/Enterprise).

Paid plans, API & data licensing

We offer paid plans and API access (Premium/Enterprise). For formal data licensing or bulk datasets, please contact us via the Contact page.

Error Handling

All API endpoints return standard HTTP status codes and JSON error responses:

Success Codes

Error Codes

Error Response Format

{ "success": false, "error": "Invalid API key", "code": "INVALID_API_KEY" }

Code Examples

cURL

curl -H "X-API-Key: rbx_your_api_key_here" \ https://rbxstats.newstargeted.com/api/v1/games

JavaScript / Node.js

const response = await fetch('https://rbxstats.newstargeted.com/api/v1/games', { headers: { 'X-API-Key': 'rbx_your_api_key_here' } }); const data = await response.json(); console.log(data);

Python

import requests headers = { 'X-API-Key': 'rbx_your_api_key_here' } response = requests.get( 'https://rbxstats.newstargeted.com/api/v1/games', headers=headers ) data = response.json() print(data)

PHP

$ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://rbxstats.newstargeted.com/api/v1/games'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'X-API-Key: rbx_your_api_key_here' ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $data = json_decode($response, true); curl_close($ch); print_r($data);

Best Practices

Support & Resources

Need help with the API? We're here to assist:

Note: API access requires an active Premium or Enterprise subscription. Upgrade your plan to get started.