Function search

Parameters

• this: API
• Optionalquery: {
      categories?:
          | "Graveyard"
          | "Pending"
          | "Ranked"
          | "Qualified"
          | "Loved"
          | "Any"
          | "Favourites"
          | "WIP"
          | "My Maps";
      cursor_string?: string;
      extra?: ("must_have_video" | "must_have_storyboard")[];
      general?: (
          | "Recommended difficulty"
          | "Include converted beatmaps"
          | "Subscribed mappers"
          | "Spotlighted beatmaps"
          | "Featured Artists"
      )[];
      genre?: | Unspecified
      | any[any]
      | Anime
      | Rock
      | Pop
      | Other
      | Novelty
      | any[any]
      | Electronic
      | Metal
      | Classical
      | Folk
      | Jazz;
      hide_explicit_content?: true;
      keywords?: string;
      language?: | Unspecified
      | English
      | Japanese
      | Chinese
      | Instrumental
      | Korean
      | French
      | German
      | Swedish
      | Spanish
      | Italian
      | Russian
      | Polish
      | Other;
      mode?: Ruleset;
      played?: "Played"
      | "Unplayed";
      rank_achieved?: (
          "Silver SS"
          | "SS"
          | "Silver S"
          | "S"
          | "A"
          | "B"
          | "C"
          | "D"
      )[];
      sort?: {
          by:
              | "artist"
              | "title"
              | "ranked"
              | "difficulty"
              | "rating"
              | "plays"
              | "favourites"
              | "updated";
          in: "asc"
          | "desc";
      };
  }

  All the filters and sorting options that you'd normally find on the website or on lazer

  • Optionalcategories?:
        | "Graveyard"
        | "Pending"
        | "Ranked"
        | "Qualified"
        | "Loved"
        | "Any"
        | "Favourites"
        | "WIP"
        | "My Maps"

    Filter in sets depending on their status or on their relation with the authorized user (defaults to all that have a leaderboard)

  • Optionalcursor_string?: string

    The thing you've got from a previous request to get another page of results!

  • Optionalextra?: ("must_have_video" | "must_have_storyboard")[]

    Should all sets have a video, a storyboard, maybe both at once?

  • Optionalgeneral?: (
        | "Recommended difficulty"
        | "Include converted beatmaps"
        | "Subscribed mappers"
        | "Spotlighted beatmaps"
        | "Featured Artists"
    )[]

    Various filters to activate

  • Optionalgenre?:
        | Unspecified
        | any[any]
        | Anime
        | Rock
        | Pop
        | Other
        | Novelty
        | any[any]
        | Electronic
        | Metal
        | Classical
        | Folk
        | Jazz

    Specify the musical genre of the music of the beatmapsets you're searching for (don't specify to get any genre)

    Remarks

    "Any"/0 actually looks up sets that specifically have the Genre "Any" such as 5947, it's excluded because it's counter-intuitive and near useless (but you can do something like 1-1 if you actually want that!)

  • Optionalhide_explicit_content?: true

    Use this to hide all sets that are marked as explicit

  • Optionalkeywords?: string

    What you'd put in the searchbar, like the name of a beatmapset or a mapper!

  • Optionallanguage?:
        | Unspecified
        | English
        | Japanese
        | Chinese
        | Instrumental
        | Korean
        | French
        | German
        | Swedish
        | Spanish
        | Italian
        | Russian
        | Polish
        | Other

    Specify the spoken language of the music of the beatmapsets you're searching for (don't specify to get any language)

    Remarks

    "Any"/0 actually looks up sets that specifically have the Language "Any" (and no set has that), it's excluded because it's counter-intuitive and near useless (but you can do something like 1-1 if you actually want that!)

  • Optionalmode?: Ruleset

    Only get sets that have maps that you can play in the ruleset of your choice

  • Optionalplayed?: "Played" | "Unplayed"

    Does the authorized user with osu!supporter have already played those sets, or have they not played them yet?

  • Optionalrank_achieved?: ("Silver SS" | "SS" | "Silver S" | "S" | "A" | "B" | "C" | "D")[]

    Does the authorized user with osu!supporter have already achieved certain ranks on those sets?

  • Optionalsort?: {
        by:
            | "artist"
            | "title"
            | "ranked"
            | "difficulty"
            | "rating"
            | "plays"
            | "favourites"
            | "updated";
        in: "asc"
        | "desc";
    }

    Sort by what, in ascending/descending order