Открытый API FPSHQ: FPS игры на любой видеокарте

Быстрый старт

Нужны slug игры и видеокарты (их дают /games?q= и /gpus?q=). Ответ — JSON, CORS открыт, ключ не нужен.

curl -s "https://fpshq.com/api/public/v1/fps?game=cyberpunk-2077&gpu=rtx-3060&res=1440p&preset=high&lang=ru"

Настоящий ответ (считается прямо сейчас):

{
    "ok": true,
    "game": {
        "slug": "cyberpunk-2077",
        "name": "Cyberpunk 2077",
        "url": "https://fpshq.com/games/cyberpunk-2077/"
    },
    "gpu": {
        "slug": "rtx-3060",
        "name": "GeForce RTX 3060",
        "brand": "NVIDIA",
        "url": "https://fpshq.com/gpu/rtx-3060/"
    },
    "cpu": null,
    "res": "1440p",
    "preset": "high",
    "fps": 49,
    "low1": 38,
    "fps_range": null,
    "expected_error_pct": null,
    "low1_range": null,
    "source": "measured",
    "basis": "measured",
    "confidence": "high",
    "verdict": {
        "key": "ok",
        "text": "Тянет",
        "basis": "1080p high"
    },
    "matrix": {
        "1080p": {
            "low": 101,
            "medium": 71,
            "high": 71,
            "ultra": 56
        },
        "1440p": {
            "low": 73,
            "medium": 59,
            "high": 49,
            "ultra": 33
        },
        "4K": {
            "low": 35,
            "medium": 28,
            "high": 24,
            "ultra": 20
        }
    },
    "matrix_range": {
        "1080p": {
            "low": null,
            "medium": null,
            "high": null,
            "ultra": null
        },
        "1440p": {
            "low": null,
            "medium": null,
            "high": null,
            "ultra": null
        },
        "4K": {
            "low": null,
            "medium": null,
            "high": null,
            "ultra": null
        }
    },
    "url": "https://fpshq.com/can-run/rtx-3060/cyberpunk-2077/",
    "methodology": "https://fpshq.com/methodology/",
    "attribution": "Source: FPSHQ (https://fpshq.com/), license CC BY 4.0 — attribution with a link is required",
    "license": "CC BY 4.0",
    "license_url": "https://creativecommons.org/licenses/by/4.0/"
}

Эндпоинты

Базовый адрес: https://fpshq.com/api/public/v1/

Параметры

• game, gpu, cpu — slug из каталога FPSHQ (как в адресе страницы: /games/{slug}/, /gpu/{slug}/)
• res — 1080p | 1440p | 4k (по умолчанию 1080p)
• preset — low | medium | high | ultra (по умолчанию high)
• lang — ru | en | ar | id | pt | tr | es — язык подписей и ссылок в ответе

Поля ответа /fps

Попробовать запрос

Лимиты, кэш и ошибки

• До 60 запросов в минуту и 10 000 в сутки с одного адреса. Остаток — в заголовке X-RateLimit-Remaining, при превышении — HTTP 429 и Retry-After.
• Ответы кэшируемые: Cache-Control и ETag (пришлите If-None-Match — получите 304 без тела). Данные FPS меняются редко — храните их у себя.
• Ошибки — JSON {ok:false, error, message}: 400 (параметры), 404 (не найдено), 429 (лимит).
• Нужно больше запросов или выгрузка целиком — напишите нам в Telegram.

HTTP/1.1 429 Too Many Requests
Retry-After: 60
{"ok":false,"error":"rate_limited","message":"Too many requests: 60 per minute. Cache responses on your side.","docs":"https://fpshq.com/api/"}

Условия использования

Данные API распространяются по лицензии CC BY 4.0 — как открытые наборы /data/: бесплатно, в том числе для коммерческих проектов. Атрибуция обязательна: рядом с данными укажите «Источник: FPSHQ» со ссылкой на страницу из поля url ответа (или на fpshq.com). Не выдавайте оценки модели за реальные замеры: поле source подскажет. CC BY 4.0 · /data/

<a href="https://fpshq.com/">Источник: FPSHQ</a>

Как считается FPS: Методика FPSHQ

Частые вопросы