RIIP
Get started
Developers · API

Server Intelligence API

Live server, discovery, trend, and analytics data over a tiered REST API. Scoped keys, per-call metering, monthly invoices with overage, and signed webhooks for usage and billing events.

A central API endpoint with authenticated request and response streams to clientsGET200 OK
servers.find
curl https://api.riip.gg/v1/servers/find \
  -H "Authorization: Bearer rk_live_..." \
  -d 'game=blade-ball&region=eu&fill=low'

{
  "results": [
    {
      "server_id": "eu-w-9f3a2",
      "players": 3, "cap": 8,
      "quality": 91,
      "region": "eu-west",
      "join_url": "https://..."
    }
  ],
  "credits_used": 1
}

Endpoints

GET
/v1/servers/find
Best live servers for a game
GET
/v1/servers/stats
Occupancy & health for a server
GET
/v1/discovery/search
Quality-ranked game search
GET
/v1/discovery/recommendations
"Games like X" vectors
GET
/v1/trends/top-games
Trending & top games by genre
GET
/v1/forecasts/occupancy
Predicted demand by region

Scoped keys

Six least-privilege scopes, immutable test/live binding; key shown once at mint.

Usage metering

Every call returns credits_used; billed monthly with overage.

Signed webhooks

SSRF-guarded, signed events for usage and billing.

Audit trails

Full logs on privileged actions across the account.

See API pricing tiers →