Usage notes

Extraits de code

curl "https://api.oanor.com/speedrun-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/speedrun-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/speedrun-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/speedrun-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "note": "Video-game speedrunning data from speedrun.com, the central community hub for competitive fastest-completion runs. /v1/games?name=mario = search games, returning each game's id, name, abbreviation, release year and weblink; /v1/categories?game=o1y9wo6q = a game's run categories (e.g. Any%, 120 Star, 100%) with their ids, type and rules; /v1/leaderboard?game=o1y9wo6q&category=wkpoo02r = the leaderboard for a game+category, returning the ranked runs with the runner name(s), finish time (in seconds and human-readable), run date and video link (top caps how many, 1-100). Get a game id from /v1/games, then a category id from /v1/categories, then the leaderboard. Data from speedrun.com (free to use). Ideal for gaming dashboards, record trackers, stream overlays and community bots.",
        "source": "speedrun.com API (speedrun.com/api/v1)",
        "endpoints": [
            "/v1/games",
            "/v1/categories",
            "/v1/leaderboard",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:41.445Z",
        "request_id": "4825cb14-c7b0-40f8-9c68-9105640100df"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}