get_league_counts {SC2API}

League and Tier Counts

Description

Provides both league (i.e. bronze, silver, etc.) and tier (1, 2, 3) player counts.

Usage

get_league_counts(season_id, queue_id, team_type, league_id, host_region)

Arguments

season_id

A numeric argument indicating a particular ladder season. Currently, league data is only available for season 28 and higher (i.e. data prior to this season is inaccessible).

queue_id

• 1 = WoL 1v1

• 2 = WoL 2v2

• 3 = WoL 3v3

• 4 = WoL 4V4

• 101 = HotS 1v1

• 102 = HotS 2v2

• 103 = HotS 3v3

• 104 = HotS 4v4

• 201 = LotV 1v1

• 202 = LotV 2v2

• 203 = LotV 3v3

• 204 = LotV 4v4

• 206 = LotV Archon

team_type

• 0 = Arranged

• 1 = Random

league_id

• 0 = Bronze

• 1 = Silver

• 2 = Gold

• 3 = Platinum

• 4 = Diamond

• 5 = Masters

• 6 = Grandmaster

host_region

The host region that the API call will be sent to. For get_league_data, the host region affects the data you will receive (i.e. different regions will result in different data). Must be one of "us", "eu", "kr", "tw", "cn". For more information on regionality, refer to Regionality and APIs.

Value

A list with tier counts and the overall league count.

Note

Data is only available for season 28 and higher.

References

• Blizzard Community API Documentation

• Regionality and APIs

Examples

# Get league counts for Season 35, LotV 2v2, randomly gathered teams,
# Bronze league, Korean region.
try({
    data <- get_league_counts(season_id = 35,
                              queue_id = 202,
                              team_type = 1,
                              league_id = 0,
                              host_region = "kr")
})