Skip to content
cyperdark edited this page May 23, 2023 · 1 revision

Returns the top scores for a beatmap

Authentication

const { auth } = require('osu-api-extended');
await auth.login(client_id, client_secret);

Function

await v2.scores.beatmap(beatmap, object)

Parameters

Parameter Type Description
beatmap number id of the beatmap
object.mode string osu or fruits or mania or taiko
object.mods string[] Array of matching mods ['HD', 'DT']
object.type string global or country or friend

Response

export interface response {
  position: number;
  accuracy: number;
  best_id: number;
  created_at: string;
  id: number;
  max_combo: number;
  mode: string;
  mode_int: number;
  mods: string[];
  passed: boolean;
  perfect: boolean;
  pp: number;
  rank: string;
  replay: boolean;
  score: number;
  statistics: {
    count_100: number;
    count_300: number;
    count_50: number;
    count_geki: number;
    count_katu: number;
    count_miss: number;
  };
  type: string;
  user_id: number;
  current_user_attributes: {
    pin: string;
  };
  user: {
    avatar_url: string;
    country_code: string;
    default_group: string;
    id: number;
    is_active: boolean;
    is_bot: boolean;
    is_deleted: boolean;
    is_online: boolean;
    is_supporter: boolean;
    last_visit: string;
    pm_friends_only: boolean;
    profile_colour: string;
    username: string;
    country: {
      code: string;
      name: string;
    };
    cover: {
      custom_url: string;
      url: string;
      id: string;
    };
  };
}

[v3.x.x] Documentation


[v2.x.x] Documentation

Clone this wiki locally