Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/RealFascinated/scoresaber-reloaded/llms.txt

Use this file to discover all available pages before exploring further.

​
Get BeatLeader Score Stats

GET /beatleader/scorestats/:scoreId Fetch detailed score statistics from BeatLeader for a specific score.
​
scoreId
number
required
The score ID
​
stats
object
Comprehensive score statistics from BeatLeader including accuracy breakdown, hand stats, and timing analysis

​
Example Request

curl https://api.scoresaber.com/beatleader/scorestats/123456789

​
Example Response

{
  "scoreId": 123456789,
  "accLeft": 95.5,
  "accRight": 96.2,
  "leftAverageScore": 113.5,
  "rightAverageScore": 114.2,
  "leftTimeDependence": 0.15,
  "rightTimeDependence": 0.12,
  "leftPreswing": 85.3,
  "rightPreswing": 87.1,
  "leftPostswing": 28.2,
  "rightPostswing": 27.1,
  "leftSpeed": 3.5,
  "rightSpeed": 3.6,
  "maxStreak": 250,
  "pauses": 0,
  "wallsHit": 0,
  "bombsHit": 0,
  "missedNotes": 5,
  "badCuts": 2,
  "handMovement": 12345.67,
  "fcAccuracy": 96.5,
  "fcPp": 265.5
}

​
Get BeatLeader Replay

GET /beatleader/replay/:scoreId Redirect to the raw BeatLeader replay file for download.
​
scoreId
string
required
The score ID with .bsor extension (e.g., 123456789.bsor)
​
redirect
string
HTTP 302 redirect to the BeatLeader replay file URL

​
Example Request

curl -L https://api.scoresaber.com/beatleader/replay/123456789.bsor

​
Response

This endpoint returns an HTTP 302 redirect to the actual replay file hosted on BeatLeader’s CDN. The replay file will be in .bsor format, which can be opened in Beat Saber replay viewers.

​
Usage Example

# Download the replay file
curl -L https://api.scoresaber.com/beatleader/replay/123456789.bsor -o replay.bsor

# Or open directly in browser
open https://api.scoresaber.com/beatleader/replay/123456789.bsor

​
Error Response

If the replay is not found: 
{
  "error": "Not Found",
  "message": "Replay not found for score \"123456789.bsor\""
}

Build docs developers (and LLMs) love

Get started for freeTalk to us