API

Overview

The speedrun.io API is live again, available under a single namespace, /v1, free for non-commercial use. See the current status page at docs.speedrun.io for what's live right now, and this page for what's planned.

Namespace	Base path	Auth	Status
Native API	/v1	None	Live

The /v1 API

/v1 is speedrun.io's own API, a read-only archive of speedrun.com run, game, and user data, collected through September 13, 2026, the archive's most recent run. It requires no authentication and no API key. Every record carries its original speedrun.com ID alongside a permanent speedrun.io ID, plus a meta.sources block declaring who owns it and under what license.

Requests are limited to 100 per minute per IP. Exceeding the limit returns a 429 with a Retry-After header; repeated violations across separate windows can result in a temporary IP blacklist. See the v1 API reference → for the full endpoint list, filters, and sort fields.

Leaderboards are not part of this release, with no current timeline. Personal bests and the ?embed= parameter are mid-development and targeted for the next iteration. See current status for details.

Documentation

Full endpoint documentation, request/response schemas, and examples are available on the docs.speedrun.io platform. The documentation is generated directly from the OpenAPI 3.1 specification and is kept in sync with the live API.

Data Ownership & Licensing

See Your Data, Your Call in the Privacy Policy and Your Data, Your Rules in the Terms of Service for the ownership guarantees that apply to data on speedrun.io.

Public data served through /v1 defaults to CC-BY-NC 4.0, consistent with the Data License page, but a record's owner can choose a different license for their own data, and that choice is reflected in the record's meta.sources block rather than applied uniformly. speedrun.io retains rights to its own proprietary data structures and delivery methods, which remain licensed for non-commercial use only; commercial redistribution or resale of speedrun.io's own infrastructure or delivery methods is not currently permitted under any arrangement.

Extended Terms

By accessing or using the speedrun.io API, you agree to the terms outlined on the Terms of Service page, plus the additional terms below.

Acceptable Use

You agree not to use the API for:

• Massive data scraping beyond the published rate limits
• Attempting to access data you have not been given access to
• Reselling or commercially redistributing /v1 data
• Any activity that interferes with the availability or integrity of the service

Violations may result in permanent IP blacklisting and/or legal action.

Contact

For questions or abuse reports: [email protected].