Speedrun.com Leaderboard & Runs Scraper
Pricing
Pay per event
Scrape speedrun.com leaderboard rankings for any game and category. Resolves game names to IDs, enumerates categories automatically, and returns flattened run rows with player names, times, ranks, WR flags, platform, region, and video links via the official v1 REST API.
Game Id
game_id
Optional
speedrun.com game ID
Game Name
game_name
Optional
Game name (international)
Game Abbreviation
game_abbreviation
Optional
Game abbreviation slug (e.g. sm64)
Game Released Year
game_released_year
Optional
Year the game was released
Category Id
category_id
Optional
speedrun.com category ID
Category Name
category_name
Optional
Category name (e.g. Any%, 120 Star, Glitchless)
Subcategory Variables
subcategory_variables
Optional
Pipe-separated subcategory variable labels (e.g. "Platform:N64 | Version:1.0"). Empty string if none.
Run Id
run_id
Optional
Unique run ID on speedrun.com
Rank
rank
Optional
Leaderboard rank (1 = world record)
Is World Record
is_world_record
Optional
True when rank equals 1
Primary Time Seconds
primary_time_seconds
Optional
Primary timed duration in seconds
Player Ids
player_ids
Optional
Pipe-separated speedrun.com user IDs of all players
Player Names
player_names
Optional
Pipe-separated display names of all players
Player Country
player_country
Optional
Country code of the first/solo player (ISO 3166-1 alpha-2)
Platform
platform
Optional
Platform name (e.g. Nintendo 64, PC)
Emulated
emulated
Optional
True if run was performed on an emulator
Region
region
Optional
Region name (e.g. JPN / NTSC, USA / NTSC)
Run Date
run_date
Optional
Date the run was performed (YYYY-MM-DD)
Verify Date
verify_date
Optional
ISO-8601 datetime when the run was verified
Video Link
video_link
Optional
Primary video URL (YouTube, Twitch, etc.)
Comment
comment
Optional
Runner-submitted comment
Examiner Id
examiner_id
Optional
speedrun.com user ID of the run examiner
Weblink
weblink
Optional
Direct URL to this run on speedrun.com
