Fuzzy-search games by name. Returns ids, abbreviations and release years.

Use the returned id (or abbreviation) with the other tools.

Get a game's details plus its categories (and optionally its levels).

The embedded categories give you the category_id needed for get_leaderboard.

List a game's categories (e.g. 'Any%', '120 Star'), with their ids and rules.

List a game's variables — the subcategories and filters a leaderboard accepts.

Each variable has an id and a values map of {value_id: label}. Pass these to get_leaderboard/get_world_record as variables={variable_id: value_id} to target a specific subcategory (e.g. '16 Star', difficulty 'Hard').

Get a ranked leaderboard for a game/category (full-game or individual level).

Players, subcategory labels and the category name are resolved for you. For subcategory filters, discover ids with list_variables first.

Get the current world record (place 1) for a game/category.

A convenience wrapper over get_leaderboard. Returns the leaderboard metadata plus world_record (the single fastest run, or None if the leaderboard is empty) and tied (any other runs also at place 1; usually empty).

Search for speedrun.com users by name. Returns ids, countries and signup dates.

Get a player's personal best runs across all games, with game/category names.

/personal-bests is unpaginated, so total_available is the player's true PB count and returned is how many came back after applying limit.

Get a run's players, times, game/category, status, system and variable values.

List speedrun.com platforms (consoles/systems) with their ids and names.

Use a returned id as the platform filter for get_leaderboard (the leaderboard API requires the platform id, not its name).

List speedrun.com regions (e.g. USA/NTSC, EUR/PAL) with their ids and names.

Use a returned id as the region filter for get_leaderboard (the leaderboard API requires the region id, not its name).

Fuzzy-search game series (e.g. 'Mario', 'Zelda') by name.

A series groups related games; pass a returned id to get_series to list the games it contains.

Get a series' details and (by default) the games it contains.

The returned game ids/abbreviations feed the other tools (get_game, list_categories, get_leaderboard).

List runs with filters — e.g. a player's recent submissions, or a game's verified/rejected runs. Newest first; combine filters to narrow down.

For just one game's moderation queue, list_unverified_runs is simpler.

Get a game's records across all its categories in one call.

With top=1 (default) this is every category's world record at once — handy for "show me all the records for ". include_levels=True also pulls every individual-level board, which can be large for level-heavy games.

List a game's runs awaiting verification — the moderation queue.

A public read (no API key needed). Pair with verify_run / reject_run (which do require a moderator key) to clear the queue.