Speedrun.com Scraper

Scrape Speedrun.com — the world's largest speedrunning leaderboard platform with thousands of games, millions of verified runs, and active communities for every genre. Search for games, pull leaderboard positions, or browse the most recent verified submissions.

Features

• Three data modes: game search, category leaderboards, or recent verified runs
• Full run metadata: time in seconds and formatted string, place on leaderboard, runner name, video proof, platform, and submission date
• Rich game data: release year, platforms, genres, community Discord, and direct links
• Human-readable time format: run times displayed as h:mm:ss.mmm or m:ss.mmm alongside raw seconds
• No authentication required: uses the public Speedrun.com REST API v1

Use Cases

• Monitor world records and top-10 leaderboard positions for popular games
• Track speedrunning community activity and new verified submissions
• Research game popularity across the speedrunning community
• Analyze run time distributions for specific categories (Any%, 100%, etc.)
• Build speedrunning news feeds and record-tracker applications

Input

Field	Type	Description	Default
mode	Select	Data mode: searchGames, leaderboard, or recentRuns	searchGames
keyword	Text	Game search keyword (mode=searchGames)	mario
gameId	Text	Game abbreviation or ID for leaderboard/recentRuns (e.g. sm64, oot, celeste)	sm64
categoryId	Text	Category ID for leaderboard mode (auto-detected if blank)	—
maxItems	Integer	Maximum number of records to return (1–500)	20

Output

Game Record

Field	Type	Description
recordType	String	Always "game"
gameId	String	Unique game ID on Speedrun.com
gameName	String	Official game name
gameAbbreviation	String	Short game abbreviation used in URLs
gameUrl	String	Direct link to the game's Speedrun.com page
releaseYear	Integer	Year the game was released
releaseDate	String	Full release date (YYYY-MM-DD)
platforms	Array	Platform names (e.g., Nintendo 64, PC)
genres	Array	Genre tags (e.g., Platformer, Action)
discord	String	Community Discord invite URL
scrapedAt	String	ISO 8601 scrape timestamp

Run Record

Field	Type	Description
recordType	String	Always "run"
runId	String	Unique run ID
runUrl	String	Direct link to the run page
gameId	String	Game ID
gameName	String	Game name
categoryId	String	Category ID
category	String	Category name (e.g., Any%, 120 Star)
timeSeconds	Number	Run time in seconds (raw float)
time	String	Formatted run time (e.g., 1:39:32.000)
place	Integer	Leaderboard position (leaderboard mode only)
runnerName	String	Runner username(s), comma-separated for co-op
runnerId	String	Runner user ID
platformId	String	Platform ID the run was submitted on
emulated	Boolean	Whether the run used emulation
videoUrl	String	Video proof URL (YouTube, Twitch, etc.)
submittedAt	String	ISO 8601 submission timestamp
status	String	Run status: verified, new, or rejected
comment	String	Runner's submission comment
scrapedAt	String	ISO 8601 scrape timestamp

Example Output

{
  "recordType": "run",
  "runId": "run12345",
  "runUrl": "https://www.speedrun.com/run/run12345",
  "gameId": "o1y9wo6q",
  "gameName": "Super Mario 64",
  "categoryId": "cat001",
  "category": "120 Star",
  "timeSeconds": 6039.0,
  "time": "1:40:39.000",
  "place": 1,
  "runnerName": "Cheese05",
  "runnerId": "player1",
  "platformId": "n64",
  "emulated": false,
  "videoUrl": "https://www.twitch.tv/videos/123456",
  "submittedAt": "2026-05-01T10:00:00Z",
  "status": "verified",
  "scrapedAt": "2026-06-04T15:30:00.000000+00:00"
}

FAQs

Does this require an API key? No. The Speedrun.com API (www.speedrun.com/api/v1) is fully public and requires no authentication for read-only data.

What game abbreviations can I use? Common examples: sm64 (Super Mario 64), oot (Ocarina of Time), celeste (Celeste), minecraft (Minecraft: Java Edition), portal2 (Portal 2). You can find a game's abbreviation in its Speedrun.com URL.

What is the difference between leaderboard and recentRuns modes? leaderboard returns the top N ranked runs for the first (or specified) category of a game, ordered by time. recentRuns returns the most recently verified runs across all games, ordered by submission date.

How are co-op runs handled? Co-op runs list all runner names joined by a comma in the runnerName field.

Are all times comparable? Only runs within the same game and category are directly comparable. Times use the primary timing method set by the game's moderators (real time, in-game time, etc.).

What is the rate limit? The Speedrun.com API enforces a rate limit with HTTP 420 responses. This scraper automatically waits and retries when rate-limited.