✈ TG

FPSHQ API

A free REST API for FPS forecasts, hardware benchmarks and PC Score. For bots, extensions, plugins and any integrations.

✓ No key JSON CORS enabled 1-hour cache
Base URL
https://fpshq.com/api/v1/

Endpoints

GET /fps?game=cyberpunk-2077&gpu=rtx-4070-super&cpu=ryzen-7-7800x3d&res=1440p&preset=ultra

FPS forecast for a game + GPU pair. Returns avg/min/max FPS, a verdict and the data source (benchmark/prediction).

▶ Try the request
GET /search?q=cyber&type=game&limit=10

Search games, GPUs and CPUs by name. type: game | gpu | cpu | all.

▶ Try the request
GET /game/{slug}

Game data: year, demandingness, Metacritic, Steam rating, minimum/recommended GPU.

▶ Try the request
GET /gpu/{slug}

GPU data: bench score, value score, tier, memory, TDP, price.

▶ Try the request
GET /cpu/{slug}

CPU data: bench score, gaming score, cores, threads, TDP.

▶ Try the request
GET /pc-score?gpu=rtx-4070-super&cpu=ryzen-9-9950x3d&ram=32

PC Score (0-100) and S–F tier calculation for a hardware pair.

▶ Try the request
GET /gpus?page=1&per_page=100

GPU catalog (paginated) — for slug discovery & sync

▶ Try the request
GET /cpus?page=1&per_page=100

CPU catalog (paginated)

▶ Try the request
GET /games?page=1&per_page=100

Game catalog (paginated, sorted by popularity)

▶ Try the request

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": 56,
  "fps_max": 85,
  "verdict": "good",
  "source": "benchmark",
  "bottleneck": { "limited_by": "GPU", "pct": 3, "gpu_load_pct": 100 },
  "url": "https://fpshq.com/games/cyberpunk-2077/"
}

Data provenance — source field

"source": "benchmark"

Measured FPS from our benchmark database (58,000+ data points across games, GPUs, resolutions and presets).

"source": "prediction"

Modeled estimate computed from the GPU benchmark score and the game's demand score, with resolution scaling and optional CPU-bottleneck correction. Used when no measured data exists for the exact combo.

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

Supported inputs

res — 1080p, 1440p, 4K (aliases: 2k → 1440p, 2160p → 4K)
preset — low, medium, high, ultra
cpu — optional in /fps; when provided, the response includes CPU-bottleneck analysis and the FPS estimate is corrected for CPU-limited scenarios
slugs — discover via /search or the /gpus, /cpus, /games catalog endpoints

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

✅ Free for commercial use — with attribution

You may use FPSHQ data in commercial and non-commercial products. The only requirement is visible attribution: a link to the relevant FPSHQ page (every API response includes a ready-to-use url field). Example: "FPS data by FPSHQ.com".

⏱ Fair-use rate limits

No API key, no hard quota. Fair use is ~60 requests/min per IP. GET responses are cached for 1 hour on our side (Cache-Control: max-age=3600) — please cache on your side as well. Need sustained higher volume or a bulk export? Contact us, we're happy to arrange it.

📬 Contact & partnership

Integration questions, higher limits, custom licensing, sample datasets: Telegram @denissatoshi.

Terms of use

The FPSHQ API is free and open. We ask one thing: when using our data, add a link to the source — FPSHQ.com. It helps the project grow. For commercial use or high request limits, message us on Telegram @denissatoshi.

The API powers our PC Power Test, browser extension and social plugins. Want to integrate FPS forecasts into your project — go ahead and use it.