BeatLeader. Clans

Interact with the BeatLeader Clan API endpoints

Methods

(static) get(searchOptions) → {Promise}

Retrieves a list of clans based on filters

Parameters:
NameTypeDescription
searchOptionsObject

Filters to narrow search. See options in table below

ParameterTypeDescriptionValid Values
pagenumber(Optional) Page number.
countnumber(Optional) Number of items per page
sortByClanSortBy(Optional) Sorting criteria"name", "pp", "acc", "rank", "count", "captures"
orderOrder(Optional) Sorting order"desc", "asc"
searchstring(Optional) Search query
Returns:

A promise with a list of clans

Type: 
Promise

(static) getById(id, searchOptions, primary) → {Promise}

Fetches details of a specific clan identified by its ID.

Parameters:
NameTypeDescription
idnumber

ID of the clan to retrieve details for

searchOptionsObject

Filters to narrow search. See options in table below

ParameterTypeDescriptionValid Values
pagenumber(Optional) Page number
countnumber(Optional) Number of items per page
sortByClanSortBy(Optional) Sorting criteria"pp", "topPp", "name", "rank", "acc", "weightedAcc", "top1Count", "top1Score", "weightedRank", "topAcc", "hmd", "playCount", "score", "lastplay", "maxStreak", "replaysWatched", "dailyImprovements", "timing"
orderOrder(Optional) Sorting order"desc", "asc"
primaryboolean

Whether to include only players for whom this clan is primary, default is false

Returns:

A promise with a clan

Type: 
Promise

(static) getByTag(tag, searchOptions, primary) → {Promise}

Retrieves details of a specific clan by tag

Parameters:
NameTypeDescription
tagstring

Tag of the clans to retrieve details for

searchOptionsObject

Filters to narrow search. See options in table below

ParameterTypeDescriptionValid Values
pagenumber(Optional) Page number
countnumber(Optional) Number of items per page
sortByClanSortBy(Optional) Sorting criteria"pp", "topPp", "name", "rank", "acc", "weightedAcc", "top1Count", "top1Score", "weightedRank", "topAcc", "hmd", "playCount", "score", "lastplay", "maxStreak", "replaysWatched", "dailyImprovements", "timing"
orderOrder(Optional) Sorting order"desc", "asc"
searchstring(Optional) Search query
primaryboolean

Whether to include only players for whom this clan is primary, default is false

Returns:

A promise with a clan

Type: 
Promise

(static) getGlobalMap() → {Promise}

Fetches a global map showing clan captured maps and rankings.

Returns:

A promise with the Global Map

Type: 
Promise

(static) getMapsById(id, searchOptions) → {Promise}

Fetches ranked maps(maps that can be captured on the global map) for where players of clan made scores identified by its ID, with optional sorting and filtering.

Parameters:
NameTypeDescription
idstring

ID of the clans to retrieve details for

searchOptionsObject

Filters to narrow search. See options in table below

ParameterTypeDescriptionValid Values
pagenumber(Optional) Page number
countnumber(Optional) Number of items per page
sortByClanSortBy(Optional) Sorting criteria"pp", "topPp", "name", "rank", "acc", "weightedAcc", "top1Count", "top1Score", "weightedRank", "topAcc", "hmd", "playCount", "score", "lastplay", "maxStreak", "replaysWatched", "dailyImprovements", "timing"
leaderboardContextLeaderboardContext(Optional) Context of leaderboard. Default is General"none", "general", "noMods", "noPause", "golf", "sCPM", "speedrun", "speedrunBackup"
orderOrder(Optional) Sorting order"desc", "asc"
Returns:

A promise with a list of ranked maps

Type: 
Promise

(static) getMapsByTag(tag, searchOptions) → {Promise}

Retrieves a list of clans based on filters

Parameters:
NameTypeDescription
tagstring

Tag of the clans to retrieve details for

searchOptionsObject

Filters to narrow search. See options in table below

ParameterTypeDescriptionValid Values
pagenumber(Optional) Page number
countnumber(Optional) Number of items per page
sortByClanSortBy(Optional) Sorting criteria"pp", "topPp", "name", "rank", "acc", "weightedAcc", "top1Count", "top1Score", "weightedRank", "topAcc", "hmd", "playCount", "score", "lastplay", "maxStreak", "replaysWatched", "dailyImprovements", "timing"
leaderboardContextLeaderboardContext(Optional) Context of leaderboard. Default is General"none", "general", "noMods", "noPause", "golf", "sCPM", "speedrun", "speedrunBackup"
orderOrder(Optional) Sorting order"desc", "asc"
Returns:

A promise with a list of ranked maps

Type: 
Promise