{"openapi":"3.1.0","info":{"title":"ScoreSaber API","version":"1.0.0","description":"Live player, score and ranking data from ScoreSaber, the global leaderboard for Beat Saber, the VR rhythm game, via its public API. ScoreSaber ranks tens of thousands of players worldwide by performance points (pp). Get a player's full profile — their pp, their global and country rank, their country, and their score statistics: total score, ranked plays and average ranked accuracy. Pull a player's plays, each with the song and mapper, the map's difficulty and star rating, the pp earned, the accuracy, the full-combo flag and the headset used. Get the top players in the world, or filtered to one country. Read ScoreSaber's global numbers — the total ranked players and the current world number one. Live, no key, nothing stored. Distinct from other gaming and social-profile APIs — this is ScoreSaber's pp ranking and its players. Perfect for leaderboard, esports and gaming-community apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/scoresaber-api","description":"oanor gateway"}],"tags":[{"name":"Players"},{"name":"Rankings"},{"name":"Stats"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/player":{"get":{"operationId":"get_v1_player","tags":["Players"],"summary":"Player profile + score stats","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"ScoreSaber player id","schema":{"type":"string"},"example":"1922350521131465"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"1922350521131465","pp":21515.25,"name":"oermergeesh","banned":false,"source":"ScoreSaber","country":"US","inactive":false,"global_rank":1,"total_score":3965871513,"country_rank":1,"total_play_count":4094,"ranked_play_count":1155,"total_ranked_score":1617837297,"average_ranked_accuracy_pct":95.8073},"meta":{"timestamp":"2026-06-10T14:02:20.839Z","request_id":"4a8d2273-8d2f-4faa-adf5-ea949becddda"},"status":"ok","message":"Player retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/scores":{"get":{"operationId":"get_v1_scores","tags":["Players"],"summary":"Player plays with pp + accuracy","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"ScoreSaber player id","schema":{"type":"string"},"example":"1922350521131465"},{"name":"sort","in":"query","required":false,"description":"top or recent","schema":{"type":"string"},"example":"top"},{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"1922350521131465","sort":"top","count":10,"scores":[{"pp":805.44,"song":"1nput This 2 Y0ur Spine","score":2081872,"stars":13.32,"mapper":"Voidless & CMP1111","set_at":"2026-01-24T03:57:56.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"Camellia","accuracy_pct":97.66,"missed_notes":0},{"pp":800.92,"song":"Echoes of Memoria","score":3057188,"stars":13.11,"mapper":"Fnyt & THMX","set_at":"2026-01-17T20:54:13.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"Ludicin","accuracy_pct":97.7039,"missed_notes":0},{"pp":784.7,"song":"Zetsubou MENBRE GIRL","score":1821302,"stars":11.01,"mapper":"Gabriel","set_at":"2026-04-20T03:51:24.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"0.1g no Gosan","accuracy_pct":98.2409,"missed_notes":0},{"pp":781.87,"song":"BUCK WILD","score":2540355,"stars":13.34,"mapper":"Bitz & Joshabi","set_at":"2026-01-09T03:04:14.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"t+pazolite","accuracy_pct":97.5321,"missed_notes":0},{"pp":781.14,"song":"Light it up","score":2101812,"stars":11.8,"mapper":"tecmonke & Cyanite","set_at":"2026-04-04T02:59:09.000Z","headset":0,"difficulty":"Expert","full_combo":true,"score_rank":1,"song_author":"Camellia","accuracy_pct":98.0032,"missed_notes":0},{"pp":777.5,"song":"Ashed Wings","score":1802756,"stars":10.82,"mapper":"VoltageO","set_at":"2026-04-20T02:41:15.000Z","headset":0,"difficulty":"Expert","full_combo":true,"score_rank":2,"song_author":"Camellia","accuracy_pct":98.2645,"missed_notes":0},{"pp":768.67,"song":"Day N Night","score":1053079,"stars":11.35,"mapper":"penguiin, Zana & RetrX","set_at":"2026-01-25T23:14:56.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"asteria","accuracy_pct":98.0744,"missed_notes":0},{"pp":767.05,"song":"DEUX EX MĀXHINĀ","score":1188592,"stars":11.02,"mapper":"Zana vs. Potassium (feat. Uadyet)","set_at":"2026-01-26T01:39:15.000Z","headset":0,"difficulty":"Expert","full_combo":true,"score_rank":1,"song_author":"Ashrount","accuracy_pct":98.163,"missed_notes":0},{"pp":764.88,"song":"NIGHTMARE † CITY","score":3167792,"stars":11.79,"mapper":"yabje vs. Mr_bjo","set_at":"2025-03-30T04:13:29.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"Camellia","accuracy_pct":97.9275,"missed_notes":0},{"pp":763.35,"song":"\"Untitled\"","score":1076189,"stars":10.21,"mapper":"WalkingKat","set_at":"2025-07-23T03:38:03.000Z","headset":0,"difficulty":"Expert+","full_combo":true,"score_rank":1,"song_author":"skav","accuracy_pct":98.3724,"missed_notes":0}],"source":"ScoreSaber"},"meta":{"timestamp":"2026-06-10T14:02:21.124Z","request_id":"25d4b639-887d-43bd-8add-d1ff1b1fa6e5"},"status":"ok","message":"Scores retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/leaderboard":{"get":{"operationId":"get_v1_leaderboard","tags":["Rankings"],"summary":"Top players worldwide or by country","description":"","parameters":[{"name":"page","in":"query","required":false,"description":"Page","schema":{"type":"string"},"example":"1"},{"name":"country","in":"query","required":false,"description":"2-letter country code","schema":{"type":"string"},"example":"DE"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":50,"source":"ScoreSaber","country":"DE","players":[{"id":"2769016623220259","pp":17722.56,"name":"NailikLP","country":"DE","global_rank":36,"country_rank":1},{"id":"76561198448469526","pp":16220.14,"name":"Dr.Bread","country":"DE","global_rank":98,"country_rank":2},{"id":"76561198253282811","pp":15377.35,"name":"Taddus","country":"DE","global_rank":170,"country_rank":3},{"id":"76561199093163807","pp":15286.95,"name":"DJ Alfred","country":"DE","global_rank":181,"country_rank":4},{"id":"76561198156925313","pp":14956.75,"name":"~Rainz~","country":"DE","global_rank":215,"country_rank":5},{"id":"76561198442753567","pp":14454.25,"name":"schonk","country":"DE","global_rank":290,"country_rank":6},{"id":"76561197970820731","pp":14367.9,"name":"hpmflash","country":"DE","global_rank":305,"country_rank":7},{"id":"76561198158199188","pp":14311.72,"name":"theMJ","country":"DE","global_rank":316,"country_rank":8},{"id":"1525854644189520","pp":14167.1,"name":"MHT","country":"DE","global_rank":353,"country_rank":9},{"id":"76561198014365525","pp":14104.07,"name":"Kakifrucht","country":"DE","global_rank":369,"country_rank":10},{"id":"26424311550506817","pp":14089.89,"name":"Alyng","country":"DE","global_rank":370,"country_rank":11},{"id":"76561199108728409","pp":14001.3,"name":"SnOwO","country":"DE","global_rank":385,"country_rank":12},{"id":"76561198081604103","pp":13981.1,"name":"Denise","country":"DE","global_rank":389,"country_rank":13},{"id":"76561198256479099","pp":13398.6,"name":"qlulezz","country":"DE","global_rank":537,"country_rank":14},{"id":"76561199082770472","pp":13359.2,"name":"Radiak","country":"DE","global_rank":546,"country_rank":15},{"id":"76561198261079083","pp":13272.9,"name":"MadlyTongstn","country":"DE","global_rank":567,"country_rank":16},{"id":"76561198102877211","pp":12933.59,"name":"Oh_DeeR","country":"DE","global_rank":663,"country_rank":17},{"id":"76561198185053291","pp":12876.33,"name":"Maomao","country":"DE","global_rank":684,"country_rank":18},{"id":"76561199427892249","pp":12856.57,"name":"Lennard1483","country":"DE","global_rank":692,"country_rank":19},{"id":"76561199215394105","pp":12848.09,"name":"pagdorn","country":"DE","global_rank":695,"country_rank":20},{"id":"76561198134792604","pp":12756.3,"name":"Morghan","country":"DE","global_rank":718,"country_rank":21},{"id":"76561198450744016","pp":12609.98,"name":"加兰","country":"DE","global_rank":780,"country_rank":22},{"id":"76561198059640408","pp":12578.9,"name":"Xenothas","country":"DE","global_rank":788,"country_rank":23},{"id":"76561198141927528","pp":12568.94,"name":"Ögö","country":"DE","global_rank":790,"country_rank":24},{"id":"76561198043329630","pp":12564.2,"name":"Im 3vo","country":"DE","global_rank":791,"country_rank":25},{"id":"76561198717300275","pp":12555.76,"name":"Severe","country":"DE","global_rank":799,"country_rank":26},{"id":"76561199486941186","pp":12509.49,"name":"KAKAFRUCHT","country":"DE","global_rank":813,"country_rank":27},{"id":"76561198280225543","pp":12474.1,"name":"GF | pascalturbo00 | TC","country":"DE","global_rank":824,"country_rank":28},{"id":"76561198888661312","pp":12391.1,"name":"Syncro","country":"DE","global_rank":854,"country_rank":29},{"id":"76561198156341945","pp":12385.5,"name":"MediumCup","country":"DE","global_rank":860,"country_rank":30},{"id":"76561199133972484","pp":12354.96,"name":"Yummy","country":"DE","global_rank":874,"country_rank":31},{"id":"76561198080297892","pp":12354.7,"name":"Timbo","country":"DE","global_rank":875,"country_rank":32},{"id":"76561199868708390","pp":12216.8,"name":"minecraft hacker 1337","country":"DE","global_rank":924,"country_rank":33},{"id":"76561198119612390","pp":12216.25,"name":"Jonas","country":"DE","global_rank":925,"country_rank":34},{"id":"76561198078527112","pp":12121.84,"name":"xTr0e","country":"DE","global_rank":970,"country_rank":35},{"id":"76561198041178440","pp":12121.16,"name":"Qwasyx","country":"DE","global_rank":971,"country_rank":36},{"id":"76561199131267169","pp":12033.8,"name":"PixlPainter","country":"DE","global_rank":1013,"country_rank":37},{"id":"76561198084474152","pp":12029.15,"name":"Bross","country":"DE","global_rank":1015,"country_rank":38},{"id":"76561198406225160","pp":11981.8,"name":"Enrico","country":"DE","global_rank":1035,"country_rank":39},{"id":"76561198191796477","pp":11944.84,"name":"Call me Daddy","country":"DE","global_rank":1047,"country_rank":40},{"id":"76561198095106486","pp":11850.4,"name":"muffn","country":"DE","global_rank":1085,"country_rank":41},{"id":"76561198429805523","pp":11743.96,"name":"Lenn","country":"DE","global_rank":1128,"country_rank":42},{"id":"76561198046825676","pp":11685.7,"name":"Fabi","country":"DE","global_rank":1153,"country_rank":43},{"id":"76561198254278301","pp":11648,"name":"Amatex","country":"DE","global_rank":1173,"country_rank":44},{"id":"76561198368143026","pp":11614.18,"name":"Zeidy","country":"DE","global_rank":1191,"country_rank":45},{"id":"76561199838311562","pp":11483.13,"name":"Aqua","country":"DE","global_rank":1259,"country_rank":46},{"id":"76561198326182067","pp":11472.9,"name":"Divine.","country":"DE","global_rank":1266,"country_rank":47},{"id":"76561198052803409","pp":11446.93,"name":"Shyphoria ^~^","country":"DE","global_rank":1283,"country_rank":48},{"id":"76561198278730757","pp":11334.31,"name":"Tulraq🐲","country":"DE","global_rank":1333,"country_rank":49},{"id":"76561197989621387","pp":11318.2,"name":"manu","country":"DE","global_rank":1345,"country_rank":50}]},"meta":{"timestamp":"2026-06-10T14:02:21.305Z","request_id":"0a7a11f4-76ba-4931-ad4a-91f5ed33509a"},"status":"ok","message":"Leaderboard retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"ScoreSaber global stats + world #1","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"ScoreSaber","world_number_one":{"id":"1922350521131465","pp":21515.25,"name":"oermergeesh","country":"US"},"total_ranked_players":39777},"meta":{"timestamp":"2026-06-10T14:02:21.562Z","request_id":"3222e4d7-90c9-4314-a48a-2c402f5fed34"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":172000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":935000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4700,"monthly_call_quota":5300000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/scoresaber-api"}