Skip to main content

Ranking API

Rank a selected list of teams from best to worst

This endpoint requires that valid Bayes team perids and date are sent with the API call:

GET - /api/ranking?team_perids={team1_perid}&team_perids={team2_perid}
&team_perids={team3_perid} ... &team_perids={teamN_perid}
&date={ISO_DATE}
&min_num_datapoints={MIN_NUM_DATAPOINTS}
parametertypedescription
team_peridsarray, stringList of Bayes perids for teams to be ranked
dateISO date formatThe date for a hypotheitical map where the team strengths apply. This date could be for an upcoming map or apply to a map in the past. Should be in format YYYY-MM-DD
min_num_datapointsintegerOptional. The minimum number of valid datapoints that a team should possess to be included in the ratings list

If the date is for a map in the future the current team strengths apply, no additional extrapolation is taken.

The perids for both teams can be found in the Bayes Fixtures Services.

The JSON response from the API call is an array string of team Bayes perids that gives the ranking of teams from best to worst.

📝 Note

Please note that the sorted list only contains teams with enough datapoints to calculate an accurate ranking. Teams with too few datapoints are dropped. This setting can be overriden by using the optional parameter min_num_datapoints but this is generally not recommended.

[
'esports:team:9bc943f6-3ac6-4a6b-9c18-577e527e5062',
'esports:team:cf4253cd-2ce9-4818-84f4-5fc918d7665b'
]