API Reference

API

Last updated: July 25, 2026

Overview

speedrun.io provides a high-performance data platform for the speedrunning community via two API namespaces, both public and free to use.

Namespace Base path Auth Status
SRC Mirror /src None Live
Native API /v1 Token Pending

SRC Mirror: /src

A faithful, high-performance read-only mirror of the speedrun.com public API. Responses are carbon copies of the upstream JSON; no fields are added, removed, or transformed. Additional headers may be included for data integrity, including API request ID, performance metrics and source data timestamps. Certain search indexes, sorting, filtering and embedding options may not be provided, as enhanced matching is a focus of /v1. For privacy reasons, only moderators and users with submitted runs will return data from the users endpoint. Removed records are honored via 404 responses. Only GET endpoints are supported. Use /src as a drop-in replacement for the speedrun.com API with significantly better availability and response times.

No authentication required. All endpoints return the same data you would get from speedrun.com, served through our infrastructure. Data is mirrored near real-time in accordance with speedrun.com rate limits. speedrun.com API partial deprecation issues, including indexing, pagination errors and missing data, have been fixed in accordance with the original API spec.

View full SRC Mirror endpoint reference →

Native API: /v1

The speedrun.io native API: a restructured, normalized schema focused on data enrichment outside of the speedrun.com platform, including enhanced run verification, VOD statistics, enhanced leaderboards, daily differential feeds and more. Free for non-commercial use. A short list of anticipated features on the /v1 roadmap:

  • Streamlined records for improved latency and smaller transfers
  • Enhanced indexes for matching performance and recommendation weighting
  • Revision support to avoid breakage with future updates
  • Extended leaderboards with community-defined rulesets
  • Integrity repair of missing and problematic records
  • Enhanced validation for runs with VODs
  • Support for unvalidated and specialty runs, including TAS
  • LiveSplit storage, analysis and archival
  • Open-source clients for simple integration via our GitHub
  • Integration support for ETL/PubSub streams and MCP

Beyond /v1, we're also building a deeper analytical layer for the community and game data. More on this as it takes shape.

Authentication optional. Anonymous requests are subject to matching /src rate limits. Bearer token authentication provides enhanced rate limits and additional features.

View full v1 API endpoint reference →

Migration Guidance

If you're currently using speedrun.com's API, migrating to speedrun.io is straightforward and accomplished via one-way ID conversion. The /v1 namespace provides matching endpoints for /src records, but utilizes SRio IDs as opposed to SRC IDs. To honor the integrity of the speedrun.com API, a /v1 endpoint will be available to offer one-way conversion of these IDs, and SRC IDs will not be made available in the /v1 namespace.

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.

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.

Data Ownership

All data under the /src namespace is provided in whole by speedrun.com, and will be maintained and unaltered as such. speedrun.io provides a mirror of this data for performance and historical preservation purposes in accordance with the terms published by speedrun.com, including the CC-BY-NC 4.0 content license applied to its API data. Please see the terms on their website for more information. speedrun.io is not affiliated with, endorsed by, or sponsored by speedrun.com or Elo Entertainment Inc.

All data under the /v1 namespace is provided by speedrun.io in accordance with the Data License, Privacy Policy and Terms of Service pages. speedrun.io retains all rights to the proprietary data structures, delivery methods, data enrichment, analytics and all unique derived works. Redistribution or commercial use requires separate permission.

Acceptable Use

You agree not to use the API for:

  • Massive data scraping beyond the published rate limits
  • Collecting /src namespace data that would violate speedrun.com API terms
  • Reselling /v1 namespace data without a commercial agreement
  • 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, abuse reports, or commercial inquiries: [email protected].