BeatLeader Endpoints

API endpoints for retrieving BeatLeader score statistics and replay files

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\""
}