Latest Runs

This page documents the requirements around the /run/ endpoint, and its extended functionality.

Command

Looking up runs can be achieved using the following command structure:

!run <game> <platform> <category> [flags]

Game

Game is either a supported game that can be looked up on main boards, or a mode switcher for a specific type of run:

• To look up category extension boards, "game" should be set to ce or catext. For details on how to use the command for Category Extensions, refer to the Category Extensions page.
• To look up multirun boards, "game" should be set to one of: multirun, multi, mr. For details on how to use the command for Multi-run boards, refer to the Multiruns page.
• To look up complex LEGO Games boards, "game" should be set to lego. For details on how to use the command for complex LEGO Games boards, refer to the LEGO Games page.

For the list of supported games/values for this parameter, refer to Supported Games.

Platform

These codes are based on a normal run. If you have set the game argument to Category Extensions, Multiruns or LEGO Games (Complex), please refer to the appropriate sub-page for relevant values that fit into this parameter.

Code	Platform
ps1	PlayStation 1
ps2	PlayStation 2
ps3	PlayStation 3
psp	PlayStation Portable
gba	Game Boy Advance
gbc	Game Boy Colour
gcn	Nintendo GameCube
xbox	Microsoft Xbox 360
pc	PC

Categories

These codes are based on normal run boards. As before, if you are looking for details relating to Category Extensions, Multiruns or LEGO Games, refer to the appropriate sub-pages.

The primary value is the most likely key that people will use to trigger this category. Aliases are alternative values that are internally mapped to the same category for convenience. If no aliases are available, then the appropriate cell will be None.

Note

This list below only covers standard/generic categories which can be commonly found on speedrun.com. For categories specific to certain game series, refer to the respective game page linked at the bottom of the supported games list.

Important

Game-specific categories are joined internally to the below generic categories within the program. Therefore, any categories below are always available, alongside those game-specific categories which exist.

Category	Primary	Aliases
Any%	any	any%
100%	100	hundo, 100%
Glitchless	gless	glitchless
No Major Skips	nms	nomajorskips
No Major Glitches	nmg	nomajorglitches

Flags

This is an optional argument after <category>: it supports any additional values that users may include.

Category extensions, multiruns and complex LEGO Games boards have additional values or requirements, please refer to the relevant subpage for additional arguments that are needed.

The /run/ endpoint (and thus the !run command) supports all flag modifiers. For a description on how this works, see the Flags page

Examples

• !run hp1 pc any --player=nixxo -> Looks for the most recent run in HP1 PC Any% for player "nixxo".
• !run hp1 ps1 100 --player=nixxo -> Looks for the most recent run in HP1 PS1 100% for player "nixxo".
• !run hp1 ps1 100 -> Looks for the most recent run in HP1 PS1 100% for the channel owner.
• !run hp1 ps1 any --world-record -> Looks for the current world record in HP1 PS1 Any%
• !run hp1 ps1 100 --position=9 -> Looks for the run in HP1 PS1 100% at position 9 on the leaderboard.