The current state of the speedrun.io API. This page will be updated if anything changes.
API access has been restored as of October 19, 2026 at 5:01am ET under the new /v1 namespace, following the recent changes to speedrun.com's TOS. The archive is static while a fuller meta source licensing system is built — see Overview for what that means for the data. Please check this page for any further updates.
| Namespace | Status | Notes |
|---|---|---|
/src | Retired | All requests return 410 Gone |
/v1 | Live | Public, unauthenticated, read-only. See the breakdown below. |
| Data syncing | Paused | No new data is currently being collected — the archive is static |
| Date | Event |
|---|---|
| October 19, 2026 | /v1 relaunched and public. Dual IDs and meta.sources licensing added to every response. |
| October 7, 2026 | /src retired (410 Gone). /v1 remained offline. |
| October 2, 2026 | API access suspended |
| Resource | Status | Notes |
|---|---|---|
/v1/categories | Live | Single-record lookup |
/v1/games | Live | Single-record + filterable, sortable list |
/v1/gametypes | Live | Single-record + list |
/v1/levels | Live | Single-record lookup |
/v1/platforms | Live | Single-record + list |
/v1/regions | Live | Single-record + list |
/v1/runs | Live | Single-record + filterable, sortable list |
/v1/series | Live | Single-record + list |
/v1/users | Live | Single-record + list |
/v1/variables | Live | Single-record lookup |
/v1/guests | Not planned | Removed |
/v1/profiles | Not planned | Removed |
/v1/developers | Future Update | Planned, via third-party sources |
/v1/engines | Future Update | Planned, via third-party sources |
/v1/genres | Future Update | Planned, via third-party sources |
/v1/publishers | Future Update | Planned, via third-party sources |
The user list has no speedrun.com equivalent — it's assembled from speedrun.io's own index of user records. An account with no submitted runs is not indexed. developers/engines/genres/publishers are empty on speedrun.com itself; speedrun.io plans to populate them from third-party metadata sources in a future update.
relational results related to a primary resource id:
| Endpoint | Status |
|---|---|
/v1/categories/{id}/variables | Live |
/v1/games/{id}/categories | Live |
/v1/games/{id}/levels | Live |
/v1/games/{id}/variables | Live |
/v1/levels/{id}/categories | Live |
/v1/levels/{id}/variables | Live |
/v1/series/{id}/games | Live |
Endpoints marked in progress return 501 with a message indicating they're planned but not yet live, not a 403, which means the path doesn't exist at all. Leaderboards are explicitly out of scope for this release. See Not included below.
Notable filter parameters and specialty matching methods:
| Endpoint | Status |
|---|---|
/v1/games/{abbreviation} | Live |
/v1/games?released={year} | Live |
/v1/games?name={fuzzy} | In Progress |
/v1/runs?orderby=date | Live |
/v1/runs?orderby=submitted | Live |
/v1/runs?orderby=verify-date | Live |
/v1/users?name={username} | Live |
/v1/users?lookup={handle} | In Progress |
/v1/runs?guest={name} | Not planned |
game, category, level, platform, region, emulated, and status are filters on /v1/runs, not sortable fields. orderby is limited to the three listed above for performance reasons. lookup is planned to cover social-handle matching (Twitch, Twitter, speedrunslive) in one parameter rather than a separate one per provider.
Complete reworks:
| Feature | Status |
|---|---|
| Leaderboards | To Be Replaced |
| Personal bests | To Be Replaced |
Embedding (?embed=) | In Progress |
Stats (?stats=) | In Progress |
Personal bests and embedding are mid-development, targeted for the next iteration. Leaderboards remain out of scope beyond that, with no current timeline. Any path not documented on the v1 API reference returns 403.