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

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

!il <game> <platform> <level> <category> [flags]

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

For the list of supported platform values for this parameter, refer to the Platform list

Levels should be a value representing the specific level you are wanting to look up. This depends entirely on the game and platform you are looking for. Depending on what game it is, please refer to the individual game pages from the sidebar.

These codes are based on normal run boards. As with game and platform, for valid values that can be used here, refer to the Categories list.

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

All uses of !il support the --player=<player_name> override. This argument is used when you are looking for a run from a player who is not defined in the <owner> parameter of the /il/ route.

Unlike /run/, you can optionally tell the system only to find the current world record. This effectively takes game, platform, level and category, and returns the top run that exists, if any. To set this requirement, provide a flag of --world-record or --wr for short-hand.

Note that, if this argument is set, then whatever is provided in <owner> and, if specified, the --player override is completely ignored, and the player name returned is the one provided in the run object returned by speedrun.com.

• !il hp1 pc flipendo any --player=nixxo -> Looks for the most recent IL submission in HP1 PC for the Flipendo Challenge Any% for player "nixxo".
• !il hp1 pc flipendo any --world-record -> Looks for the current IL world record for HP1 PC in the Flipendo Challenge Any% board.