FPSHQ API

Endpoints

Example /fps response

{
  "ok": true,
  "game": { "slug": "cyberpunk-2077", "name": "Cyberpunk 2077" },
  "gpu": { "slug": "rtx-4070-super", "name": "GeForce RTX 4070 Super" },
  "cpu": { "slug": "ryzen-7-7800x3d", "name": "Ryzen 7 7800X3D" },
  "resolution": "1440p",
  "preset": "ultra",
  "fps": 72,
  "fps_min": 58,
  "fps_max": 88,
  "fps_range": [58, 88],
  "expected_error_pct": 21.3,
  "fps_1pct_low": 56,
  "fps_1pct_low_range": [45, 69],
  "verdict": "good",
  "source": "prediction",
  "basis": "model",
  "bottleneck": { "limited_by": "GPU", "pct": 3, "gpu_load_pct": 100 },
  "url": "https://fpshq.com/games/cyberpunk-2077/"
}

Data provenance — source field

fps_range / fps_min–fps_max: for model estimates where at least one held-out check source has a median error above 25 % (FPSHQ backtest by GPU class and resolution, model accuracy) — an interval around the median error that holds about half of held-out benchmarks (three sources weighted equally); otherwise both equal fps and fps_range is null. fps_1pct_low_range — the same interval for 1% low. Quote the range, not the single number.

Every /fps response carries this field, so measured benchmarks and modeled predictions are always distinguishable — label them accordingly in your product.

Supported inputs

Quick start

// JavaScript
const r = await fetch('https://fpshq.com/api/v1/fps?game=cyberpunk-2077&gpu=rtx-4070-super&cpu=ryzen-7-7800x3d&res=1440p&preset=ultra');
const data = await r.json();
console.log(`${data.fps} FPS (${data.source})`);   // 72 FPS (benchmark)

# curl
curl "https://fpshq.com/api/v1/fps?game=cyberpunk-2077&gpu=rtx-4070-super&res=1440p"

CORS is enabled (Access-Control-Allow-Origin: *) — the API can be called directly from browsers, extensions and mobile apps. No API key required.

License, attribution & rate limits