# osu-api-v2-js [![Node.js Test CI](https://github.com/TTTaevas/osu-api-v2-js/actions/workflows/test.yml/badge.svg)](https://github.com/TTTaevas/osu-api-v2-js/actions/workflows/test.yml) [![Chat on Matrix](https://matrix.to/img/matrix-badge.svg)](https://matrix.to/#/!UDoTSsVxLnywpVCGmE:matrix.org) [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/V7V4J78L0) [**osu-api-v2-js**](https://github.com/TTTaevas/osu-api-v2-js) is a JavaScript & TypeScript package that helps you interact with [osu!api (v2)](https://osu.ppy.sh/docs/). The documentation for the latest version of this package can be found at any time on [osu-v2.taevas.xyz](https://osu-v2.taevas.xyz)! ## How to install and get started Before installing, if using Node.js, check if you're running version 20 or above: ```bash node -v # displays your version of node.js ``` Then to install the package, use a command from your package manager: ```bash npm i osu-api-v2-js # if using npm yarn add osu-api-v2-js # if using yarn pnpm add osu-api-v2-js # if using pnpm bun a osu-api-v2-js # if using bun ``` You will want to create your own OAuth application: https://osu.ppy.sh/home/account/edit#oauth To use (import) the package in your project and start interacting with the API, you may do something like that: ```typescript // TypeScript import * as osu from "osu-api-v2-js"; async function logUserTopPlayBeatmap(username: string) { // Create an API object, it'll automatically get an access_token which it'll use in future requests const api = new osu.API(client_id, ""); // id as a number, secret as a string const user = await api.getUser(username); // We need to get the id of the user in order to request what we want const scores = await api.getUserScores( user, "best", osu.Ruleset.osu, { lazer: false }, { limit: 1 }, ); // Specifying the Ruleset is optional const score = scores[0]; // Array is already sorted const beatmapDifficulty = await api.getBeatmapDifficultyAttributesOsu( score.beatmap, score.mods, ); // Specify the mods to get the appropriate SR const x = `${score.beatmapset.artist} - ${score.beatmapset.title} [${score.beatmap.version}]`; const y = `+${score.mods.map((m) => m.acronym).toString()} (${beatmapDifficulty.star_rating.toFixed(2)}*)`; console.log(`${username}'s top play is on: ${x} ${y}`); // Doomsday fanboy's top play is on: Erio o Kamattechan - os-Uchuujin(Asterisk Makina Remix) [Mattress Actress] +DT,CL (8.87*) } logUserTopPlayBeatmap("Doomsday fanboy"); ``` ### Configuration options Your [`api`](https://osu-v2.taevas.xyz/classes/API.html) object has many properties (listed as _Accessors_ in the documentation) which you can modify in order to change its behaviour. There are two ways to do that, the first of which is to do it at any point after you've created your object: ```typescript const api = new osu.API(0, ""); // Log all requests made by this api object api.verbose = "all"; // Change the amount of seconds it takes for requests to timeout api.timeout = 10; ``` The other way would be at the same time you're creating your `api` object, like that: ```typescript // Same as above, in one line as the api object gets created const api = new osu.API(0, "", { verbose: "all", timeout: 10 }); ``` ### Tokens An [`access_token`](https://osu-v2.taevas.xyz/classes/API.html#access_token) is required to access the API, and should be valid for 24 hours. When you first create your [`api`](https://osu-v2.taevas.xyz/classes/API.html) object, that token is automatically set before any request is made, so you don't have to worry about that! But how about after those 24 hours? Once an `access_token` has become invalid, the server will no longer respond correctly to requests made with it, instead responding with [401](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/401). Thankfully, there are solutions to get and set new `access_token`s in a convenient way, so there is no need to create a new `api` object every day! - If you'd like to manually get a new `access_token`, calling [`setNewToken()`](https://osu-v2.taevas.xyz/classes/API.html#setnewtoken) will replace your previous token with a new one - Keep the [`set_token_on_expires`](https://osu-v2.taevas.xyz/classes/API.html#set_token_on_expires) option to true if you'd like the object to call it automatically as soon as the token expires - By default, the [`set_token_on_401`](https://osu-v2.taevas.xyz/classes/API.html#set_token_on_401) option is set to true, which (as its name indicates) will do that upon encountering a 401 - When that happens, if [`retry_on_new_token`](https://osu-v2.taevas.xyz/classes/API.html#retry_on_new_token) is set to true as it is by default, it will retry the request it has encountered a 401 on, with the new token! (note that loops are prevented, it won't retry or get another token if the same request with the new token gets a 401) At any point in time, you can see when the current `access_token` is set to expire through the [`expires`](https://osu-v2.taevas.xyz/classes/API.html#expires) property of the API. You may also choose to manually invalidate your `access_token` through [`revokeToken()`](https://osu-v2.taevas.xyz/classes/API.html#revoketoken) instead of waiting for it to expire! ### Retries Your `api` object has a configurable behaviour when it comes to handling requests that have failed for certain reasons. It may "retry" a request, meaning **not throwing and making the request again as if it hasn't failed** under the following circumstances: NOTE: [`retry_maximum_amount`](https://osu-v2.taevas.xyz/classes/API.html#retry_maximum_amount) must be above 0 for any retry to happen in the first place! - [`set_token_on_401`](https://osu-v2.taevas.xyz/classes/API.html#set_token_on_401) is set, a token is obtained thanks to it, and [`retry_on_new_token`](https://osu-v2.taevas.xyz/classes/API.html#retry_on_new_token) is also set - A failed request has a status code featured in [`retry_on_status_codes`](https://osu-v2.taevas.xyz/classes/API.html#retry_on_status_codes) - [`retry_on_timeout`](https://osu-v2.taevas.xyz/classes/API.html#retry_on_timeout) is set and a timeout has happened You can further configure retries through [`retry_delay`](https://osu-v2.taevas.xyz/classes/API.html#retry_delay) and the aforementioned `retry_maximum_amount`. ### Authorization flow A simple guide on how to do extra fancy stuff #### Create and share the authorization link with your users If your application is meant to act on behalf of a user after they've clicked on a button to say they **"consent to your application identifying them and reading public data on their behalf and some other stuff maybe"**, then you will need to take a slightly different approach to create your `api` object. Let's take it step by step! First, this package comes with [`generateAuthorizationURL()`](https://osu-v2.taevas.xyz/functions/generateAuthorizationURL.html), which will create a link for you that you can share so users can click on it and allow your application to do stuff on their behalf. This function requires you to specify [scopes](https://osu-v2.taevas.xyz/types/Scope.html). Here are some useful things to know about scopes: - `identify` is always **implicitly SPECIFIED**, so you should always use it - `public` is always **implicitely REQUIRED**, so you should (basically) always use it - when a method requires another scope, it will be **explicit** about it in its documentation - ultimately, **the user is the one who decides which scopes they allow**, so code assuming they may have allowed no scope at all - scopes that have been allowed **can be checked at any time** through [the `scopes` property of your `api` object](https://osu-v2.taevas.xyz/classes/API.html#scopes) The TLDR of scopes: Use `identify` and `public`, add other scopes on top of that when necessary! #### Have a server ready to receive the authorization The user clicked your link and authorized your application! ...Now what? When a user authorizes your application, they get redirected to your `Application Callback URL` with a _huge_ code as a GET parameter (the name of the parameter is `code`), and it is this very code that will allow you to proceed with the authorization flow! So make sure that somehow, you retrieve this code! With this code, you're able to create your [`api`](https://osu-v2.taevas.xyz/classes/API.html) object: ```typescript const api = await osu.API.createAsync(client_id, "", { redirect_uri: "", code: "", }); ``` Here to create our API object, we use [the `createAsync` method](https://osu-v2.taevas.xyz/classes/API.html#createasync) so that we can potentially catch an error that can easily happen, for example if the user decides _not_ to authorize your application. Alternatively, we can use the regular constructor to safely construct the `api` object, and _then_ deal with the authorization: ```typescript const api = new osu.API(client_id, "", { set_token_on_creation: false, }); await api.setNewToken({ redirect_uri: "", code: "", }); // at any point before the first request ``` #### Keep your api object somewhere safe Congrats on making your `api` object! As you may have seen from glancing at the documentation, it is pretty important as it holds a lot of information, such as the [`refresh_token`](https://osu-v2.taevas.xyz/classes/API.html#refresh_token) which is needed to get a new `access_token` without asking the user for their consent again. So as a reminder, it has: - Both the `access_token` and the `refresh_token`, as well as the expiry date - The scopes that have been granted, and the id of the user under the [`user`](https://osu-v2.taevas.xyz/classes/API.html#user) property - All kinds of options and methods to use and deal with the tokens Everything is available to read about in the documentation! #### Full example Here's a full example where you will launch a server that will: - listen for an authorization code - create the authorization URL and open it in your browser - create the api object with the authorization code it has received - get your user id and username from that ```typescript // TypeScript import * as osu from "osu-api-v2-js"; import * as http from "http"; import { exec } from "child_process"; // This should be from an application registered on https://osu.ppy.sh/home/account/edit#oauth const id = 0; // replace with your client id const secret = ""; const redirect_uri = ""; // assuming localhost with any unused port for convenience (like http://localhost:7272/) // Because we need to act as an authenticated user, we need to go through the authorization procedure // This function largely takes care of it by itself async function getCode(authorization_url: string): Promise { // Open a temporary server to receive the code when the browser is sent to the redirect_uri after confirming authorization const httpserver = http.createServer(); const host = redirect_uri.substring( redirect_uri.indexOf("/") + 2, redirect_uri.lastIndexOf(":"), ); const port = Number( redirect_uri.substring(redirect_uri.lastIndexOf(":") + 1).split("/")[0], ); httpserver.listen({ host, port }); // Open the browser to the page on osu!web where you click a button to say you authorize your application console.log("Waiting for code..."); const command = process.platform == "darwin" ? "open" : process.platform == "win32" ? "start" : "xdg-open"; exec(`${command} "${authorization_url}"`); // Check the URL for a `code` GET parameter, get it if it's there const code: string = await new Promise((resolve) => { httpserver.on("request", (request, response) => { if (request.url) { console.log("Received code!"); response.end("Worked! You may now close this tab.", "utf-8"); httpserver.close(); // Close the temporary server as it is no longer needed resolve(request.url.substring(request.url.indexOf("code=") + 5)); } }); }); return code; } async function getSelf() { // Get the code needed for the api object const url = osu.generateAuthorizationURL(id, redirect_uri, [ "public", "identify", ]); const code = await getCode(url); const api = await osu.API.createAsync( id, secret, { redirect_uri, code }, { verbose: "all" }, ); // Use the `me` endpoint, which gives information about the authorized user! const me = await api.getResourceOwner(); console.log("My id is", me.id, "but I'm better known as", me.username); // If you're not gonna use the token anymore, might as well revoke it for the sake of security await api .revokeToken() .then(() => console.log("Revoked the token, it can no longer be used!")); } getSelf(); ``` If you're looking for an example that involves WebSockets, you might wanna take a look at `lib/tests/websocket.ts` in the package's repository! ### Bot accounts (delegate scope) If you are lucky, you may be in possession of a [bot account](https://osu.ppy.sh/wiki/en/Bot_account), which can also create OAuth applications. However, those applications can be used with the "delegate" scope, alongside [other scopes marked as "can delegate" on the official documentation](https://osu.ppy.sh/docs/#client-credentials-delegation)! This allows you, thanks to the application's id and secret, to do things with the bot account that would usually require going through the aforementioned authorization flow, such as sending chat messages or even creating posts on the forums. It's very powerful, although the "public" scope is incompatible, which is needed to access most endpoints! This package supports that feature, all you need to do is to **specify the scopes when you create your API object.** This can be done through configuration options, like this: ```typescript // Assuming we want to write in chat through the bot account const api = new osu.API(0, "", { scopes: ["delegate", "chat.write"], }); const api = await osu.API.createAsync(0, "", undefined, { scopes: ["delegate", "chat.write"], }); // Alternative with `createAsync()` ``` ### Calling the functions, but literally This package's functions can be accessed both through the api object and through namespaces! It essentially means that for convenience's sake, there are two ways to do anything: ```typescript // Obtaining a match, assuming an `api` object already exists and everything from the package is imported as `osu` const match_1 = await api.getMatch(103845156); // through the api object const match_2 = await osu.Match.getOne.call(api, 103845156); // through the namespaces // `match_1` and `match_2` are the same, because they're essentially using the same function! // The same, but for obtaining multiple lazer updates const builds_1 = await api.getChangelogBuilds("lazer"); const builds_2 = await osu.Changelog.Build.getMultiple.call(api, "lazer"); // `build_1` and `build_2` are also the same! ``` As you may have noticed, when calling the functions through the namespaces, instead of doing something like `getOne()`, we instead do `getOne.call()` and use [the call() method](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/call) in order to provide a `this` value; the api object! Of course, using [the apply() method](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/apply) would also work, so just do things the way you prefer or the way that is more intuitive to you! ## List of endpoints and their functions In the same order as on [the API's official documentation](https://osu.ppy.sh/docs/): ### Account - `GET /me/beatmapset-favourites` -> [getFavouriteBeatmapsetsIds()](https://osu-v2.taevas.xyz/classes/API.html#getfavouritebeatmapsetsids) ### Beatmap Packs - `GET /beatmaps/packs` -> [getBeatmapPacks()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmappacks) - `GET /beatmaps/packs/{pack}` -> [getBeatmapPack()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmappack) ### Beatmaps - `GET /beatmaps/lookup` -> [lookupBeatmap()](https://osu-v2.taevas.xyz/classes/API.html#lookupbeatmap) - `GET /beatmaps/{beatmap}/scores/users/{user}` -> [getBeatmapUserScore()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapuserscore) - `GET /beatmaps/{beatmap}/scores/users/{user}/all` -> [getBeatmapUserScores()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapuserscores) - `GET /beatmaps/{beatmap}/scores` -> [getBeatmapScores()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapscores) - `GET /beatmaps/{beatmap}/solo-scores` -> Not supported (deprecated endpoint) - `GET /beatmaps` -> [getBeatmaps()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmaps) - `GET /beatmaps/{beatmap}` -> [getBeatmap()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmap) - `POST /beatmaps/{beatmap}/attributes` -> [getBeatmapDifficultyAttributes()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapdifficultyattributes) ### Beatmapset Discussions - `GET /beatmapsets/discussions/posts` -> [getBeatmapsetDiscussionPosts()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapsetdiscussionposts) - `GET /beatmapsets/discussions/votes` -> [getBeatmapsetDiscussionVotes()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapsetdiscussionvotes) - `GET /beatmapsets/discussions` -> [getBeatmapsetDiscussions()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapsetdiscussions) ### Beatmapsets - `GET /beatmapsets/search` -> [searchBeatmapset()](https://osu-v2.taevas.xyz/classes/API.html#searchbeatmapsets) - `GET /beatmapsets/lookup` -> [lookupBeatmapset()](https://osu-v2.taevas.xyz/classes/API.html#lookupbeatmapset) - `GET /beatmapsets/{beatmapset}` -> [getBeatmapset()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapset) - `GET /beatmapsets/{beatmapset}/download` -> Not supported (only lazer clients) ### Changelog - `GET /changelog/{stream}/{build}` -> [getChangelogBuild()](https://osu-v2.taevas.xyz/classes/API.html#getchangelogbuild) - `GET /changelog` -> [getChangelogBuilds()](https://osu-v2.taevas.xyz/classes/API.html#getchangelogbuilds) and [getChangelogStreams()](https://osu-v2.taevas.xyz/classes/API.html#getchangelogstreams) (removing `search`, putting `builds` behind getChangelogBuilds(), and `streams` behind getChangelogStreams()) - `GET /changelog/{changelog}` -> [lookupChangelogBuild()](https://osu-v2.taevas.xyz/classes/API.html#lookupchangelogbuild) ### Chat - `POST /chat/ack` -> [keepChatAlive()](https://osu-v2.taevas.xyz/classes/API.html#keepchatalive) - `POST /chat/new` -> [sendChatPrivateMessage()](https://osu-v2.taevas.xyz/classes/API.html#sendchatprivatemessage) - `GET /chat/updates` -> Not supported (only lazer clients) - `GET /chat/channels/{channel}/messages` -> [getChatMessages()](https://osu-v2.taevas.xyz/classes/API.html#getchatmessages) - `POST /chat/channels/{channel}/messages` -> [sendChatMessage()](https://osu-v2.taevas.xyz/classes/API.html#sendchatmessage) - `PUT /chat/channels/{channel}/users/{user}` -> [joinChatChannel()](https://osu-v2.taevas.xyz/classes/API.html#joinchatchannel) - `DELETE /chat/channels/{channel}/users/{user}` -> [leaveChatChannel()](https://osu-v2.taevas.xyz/classes/API.html#leavechatchannel) - `PUT /chat/channels/{channel}/mark-as-read/{message}` -> [markChatChannelAsRead()](https://osu-v2.taevas.xyz/classes/API.html#markchatchannelasread) - `GET /chat/channels` -> [getChatChannels()](https://osu-v2.taevas.xyz/classes/API.html#getchatchannels) - `POST /chat/channels` -> [createChatPrivateChannel()](https://osu-v2.taevas.xyz/classes/API.html#createchatprivatechannel) and [createChatAnnouncementChannel()](https://osu-v2.taevas.xyz/classes/API.html#createchatannouncementchannel) - `GET /chat/channels/{channel}` -> [getChatChannel()](https://osu-v2.taevas.xyz/classes/API.html#getchatchannel) (without `users` because `channel` would already have this property) ### Comments - `GET /comments` -> [getComments()](https://osu-v2.taevas.xyz/classes/API.html#getcomments) - `POST /comments` -> Not supported (only lazer clients) - `GET /comments/{comment}` -> [getComment()](https://osu-v2.taevas.xyz/classes/API.html#getcomment) - `PUT /comments/{comment}` -> Not supported (only lazer clients) - `DELETE /comments/{comment}` -> Not supported (only lazer clients) - `POST /comments/{comment}/vote` -> Not supported (only lazer clients) - `DELETE /comments/{comment}/vote` -> Not supported (only lazer clients) ### Events - `GET /events` -> [getEvents()](https://osu-v2.taevas.xyz/classes/API.html#getevents) ### Forum - `POST /forums/topics/{topic}/lock` -> [lockForumTopic()](https://osu-v2.taevas.xyz/classes/API.html#lockforumtopic) - `POST /forums/topics/{topic}/move` -> Not supported (only lazer clients) - `POST /forums/topics/{topic}/pin` -> [pinForumTopic()](https://osu-v2.taevas.xyz/classes/API.html#pinforumtopic) - `POST /forums/topics/{topic}/reply` -> [replyForumTopic()](https://osu-v2.taevas.xyz/classes/API.html#replyforumtopic) - `GET /forums/topics` -> [getForumTopics()](https://osu-v2.taevas.xyz/classes/API.html#getforumtopics) - `POST /forums/topics` -> [createForumTopic()](https://osu-v2.taevas.xyz/classes/API.html#createforumtopic) - `GET /forums/topics/{topic}` -> [getForumTopic()](https://osu-v2.taevas.xyz/classes/API.html#getforum) (removing `search` for simplicity) - `PUT /forums/topics/{topic}` -> [editForumTopicTitle()](https://osu-v2.taevas.xyz/classes/API.html#editforumtopictitle) - `PUT /forums/posts/{post}` -> [editForumPost()](https://osu-v2.taevas.xyz/classes/API.html#editforumpost) - `GET /forums` -> [getForums()](https://osu-v2.taevas.xyz/classes/API.html#getforums) - `GET /forums/{forum}` -> [getForum()](https://osu-v2.taevas.xyz/classes/API.html#getforum) ### Home - `GET /search` -> [searchUser()](https://osu-v2.taevas.xyz/classes/API.html#searchuser) and [searchWiki()](https://osu-v2.taevas.xyz/classes/API.html#searchwiki) ### Matches - `GET /matches` -> [getMatches()](https://osu-v2.taevas.xyz/classes/API.html#getmatches) - `GET /matches/{match}` -> [getMatch()](https://osu-v2.taevas.xyz/classes/API.html#getmatch) ### Multiplayer - `GET /rooms/{room}/playlist/{playlist}/scores/users/{user}` -> Not supported (only lazer clients) - `GET /rooms/{room}/playlist/{playlist}/scores` -> [getPlaylistItemScores()](https://osu-v2.taevas.xyz/classes/API.html#getplaylistitemscores) - `GET /rooms/{room}/playlist/{playlist}/scores/{score}` -> Not supported (only lazer clients) - `GET /rooms` -> [getRooms()](https://osu-v2.taevas.xyz/classes/API.html#getrooms) ### News - `GET /news` -> [getNewsPosts()](https://osu-v2.taevas.xyz/classes/API.html#getnewsposts) (removing everything except `news_sidebar.news_posts`) - `GET /news/{news}` -> [getNewsPost()](https://osu-v2.taevas.xyz/classes/API.html#getnewspost) ### Ranking - `GET /rankings/kudosu` -> [getKudosuRanking()](https://osu-v2.taevas.xyz/classes/API.html#getkudosuranking) - `GET /rankings/{mode}/{type}` -> [getUserRanking()](https://osu-v2.taevas.xyz/classes/API.html#getuserranking) and [getCountryRanking()](https://osu-v2.taevas.xyz/classes/API.html#getcountryranking) and [getSpotlightRanking()](https://osu-v2.taevas.xyz/classes/API.html#getspotlightranking) - `GET /spotlights` -> [getSpotlights()](https://osu-v2.taevas.xyz/classes/API.html#getspotlights) ### Scores - `GET /scores` -> [getScores()](https://osu-v2.taevas.xyz/classes/API.html#getscores) - `POST /score-pins/{score}/reorder` -> Not supported (only lazer clients) - `DELETE /score-pins/{score}` -> Not supported (only lazer clients) - `PUT /score-pins/{score}` -> Not supported (only lazer clients) ### Teams - `GET /teams/{team}/{ruleset?}` -> [getTeam()](https://osu-v2.taevas.xyz/classes/API.html#getteam) ### Under "Undocumented" or missing from docs - `GET /beatmapsets/events` -> [getBeatmapsetEvents()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapsetevents) - `GET /rooms/{room}/leaderboard` -> [getRoomLeaderboard()](https://osu-v2.taevas.xyz/classes/API.html#getroomleaderboard) - `GET /rooms/{room}/events` -> [getRoomEvents()](https://osu-v2.taevas.xyz/classes/API.html#getroomevents) - `GET /rooms/{room}` -> [getRoom()](https://osu-v2.taevas.xyz/classes/API.html#getroom) - `GET /seasonal-backgrounds` -> [getSeasonalBackgrounds()](https://osu-v2.taevas.xyz/classes/API.html#getseasonalbackgrounds) - `GET /scores/{score}/download` -> [getReplay()](https://osu-v2.taevas.xyz/classes/API.html#getreplay) - `GET /scores/{rulesetOrScore}/{score?}` -> [getScore()](https://osu-v2.taevas.xyz/classes/API.html#getscore) - `GET /users/lookup` -> [lookupUsers()](https://osu-v2.taevas.xyz/classes/API.html#lookupusers) - `GET /friends` -> [getFriends()](https://osu-v2.taevas.xyz/classes/API.html#getfriends) - `GET /tags` -> [getBeatmapUserTags()](https://osu-v2.taevas.xyz/classes/API.html#getbeatmapusertags) - While other endpoints exist, they are only officially supported through the lazer client ### Users - `GET /users/{user}/kudosu` -> [getUserKudosuHistory()](https://osu-v2.taevas.xyz/classes/API.html#getuserkudosuhistory) - `GET /users/{user}/scores/{type}` -> [getUserScores()](https://osu-v2.taevas.xyz/classes/API.html#getuserscores) - `GET /users/{user}/beatmapsets/{type}` -> [getUserBeatmaps()](https://osu-v2.taevas.xyz/classes/API.html#getuserbeatmaps) and [getUserMostPlayed()](https://osu-v2.taevas.xyz/classes/API.html#getusermostplayed) - `GET /users/{user}/recent_activity` -> [getUserRecentActivity()](https://osu-v2.taevas.xyz/classes/API.html#getuserrecentactivity) - `GET /users/{user}/beatmaps-passed` -> [getUserPassedBeatmaps()](https://osu-v2.taevas.xyz/classes/API.html#getuserpassedbeatmaps) - `GET /users/{user}/{mode?}` -> [getUser()](https://osu-v2.taevas.xyz/classes/API.html#getuser) - `GET /users` -> [getUsers()](https://osu-v2.taevas.xyz/classes/API.html#getusers) - `GET /me/{mode?}` -> [getResourceOwner()](https://osu-v2.taevas.xyz/classes/API.html#getresourceowner) - `GET /me/achievements/{achievementId}` -> Not supported (only lazer clients) ### Wiki - `GET /wiki/{locale}/{path}` -> [getWikiPage()](https://osu-v2.taevas.xyz/classes/API.html#getwikipage)