Build on Roseek data

Same read-only product data as the Pro web app — Potential, live CCU, history, D1/D7 retention, blowups — over HTTP. You buy usage tokens (min $5). Every call spends tokens. Balance goes down until you top up. Not a monthly plan.

v1 · /api/v1 Prepaid tokens Balance only goes down Min $5

How pricing works

from $5

500 usage tokens per $1.
Min pack: 2,500 tokens for $5.

How spend works

List pages: 1 token per game in limit
(limit=20 → 20 tokens, not 1)
Single game / detail: 1 token · Search: 10

$5 ≈ 2,500 game-rows ≈ 125× pages of 20. Header: X-SR-Tokens-Cost

Buy tokens on Discord Try in OpenAPI JSON index

Back off when warned. Codes: BALANCE_SOFT (running low — buy more), BALANCE_EMPTY (402 — no tokens left), RATE_SOFT / RATE_LIMITED (per-minute cap). Do not retry-spam when empty — top up first.

Example packs

Pay	Usage tokens	~API calls
$5	2,500	~2.5k game-rows · ~125 pages×20
$10	5,000	~5k game-rows · ~250 pages×20
$20	10,000	~10k game-rows · ~500 pages×20
$50	25,000	~25k game-rows · ~1,250 pages×20

Authentication

After you pay, you get a key + loaded balance. Key is shown once.

Authorization: Bearer sr_live_your_key_here
# or
X-Api-Key: sr_live_your_key_here

Check balance

curl -s -H "Authorization: Bearer sr_live_…" \
  https://YOUR_DOMAIN/api/v1/me

# Response includes token.balance_tokens
# Header: X-SR-Tokens-Remaining

Quick start

curl -s \
  -H "Authorization: Bearer sr_live_…" \
  "https://YOUR_DOMAIN/api/v1/potential?tier=Buy&limit=20"

curl -s \
  -H "Authorization: Bearer sr_live_…" \
  "https://YOUR_DOMAIN/api/v1/retention?sort=d1&limit=10&only_with_rate=true"

Endpoints

Full detail in PUBLIC_API.md.

GET/api/v1 — index (no auth)

GET/api/v1/me — key + balance_tokens

GET/api/v1/games · /games/{id} · history

GET/api/v1/potential · status

GET/api/v1/retention · one game

GET/api/v1/blowups · ranks

GET/api/v1/live-speed · /search

Warning codes

Code	HTTP	Action
BALANCE_SOFT	200	Tokens running low — buy more soon
BALANCE_EMPTY	402	Balance 0 — stop and top up (min $5)
RATE_SOFT	200	Near RPM ceiling — space requests
RATE_LIMITED	429	Wait `Retry-After`
TOKEN_*	401	Fix key / re-mint

Headers every response

X-SR-Tokens-Remaining: 12480
X-SR-Tokens-Cost: 1
X-SR-Tokens-Per-Usd: 500
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 41
X-SR-Warning: BALANCE_SOFT
X-SR-Billing: prepaid