Request a list of strings used by the API.

Endpoint

/api/strings

Request Parameters

game (Required)

Game (see table above)

language (Optional, defaults to en)

Language (see table above)

Example Request

Request the current leaderboards

Endpoint

/api/leaderboard

Request Parameters

game (Required)

Game (see table above)

leaderboard_id (leaderboard_id or event_leaderboard_id required)

Leaderboard ID (see table above)

event_leaderboard_id (leaderboard_id or event_leaderboard_id required)

Event Leaderboard ID (see table above)

start (Required)

Starting rank (Ignored if search, steam_id, or profile_id are defined)

count (Required)

Number of leaderboard entries to get (Must be 10000 or less))

search (Optional)

Name Search

steam_id (Optional)

steamID64 (ex: 76561199003184910)

profile_id (Optional)

Profile ID (ex: 459658)

Example Request

Request the rating history for a player

Endpoint

/api/player/ratinghistory

Request Parameters

game (Required)

Game (see table above)

leaderboard_id (leaderboard_id or event_leaderboard_id required)

Leaderboard ID (see table above)

event_leaderboard_id (leaderboard_id or event_leaderboard_id required)

Event Leaderboard ID (see table above)

start (Required)

Starting match (0 is the most recent match)

count (Required)

Number of matches to get (Must be 10000 or less))

steam_id (steam_id or profile_id required)

steamID64 (ex: 76561199003184910)

profile_id (steam_id or profile_id required)

Profile ID (ex: 459658)

Example Request

Request the match history for a player

Endpoint

/api/player/matches

Request Parameters

game (Required)

Game (see table above)

start (Optional)

Starting match (0 is the most recent match. Ignored if requesting matches from multiple players)

count (Required)

Number of matches to get (Must be 1000 or less))

steam_id (steam_id(s) or profile_id(s) required)

steamID64 (ex: 76561199003184910)

profile_id (steam_id(s) or profile_id(s) required)

Profile ID (ex: 459658)

steam_ids (steam_id(s) or profile_id(s) required)

steamID64 (ex: 76561199003184910,76561198449406083)

profile_ids (steam_id(s) or profile_id(s) required)

Profile ID (ex: 459658,199325)

Example Request

Request rank details about a player

Request Parameters

game (Required)

Game (see table above)

leaderboard_id (leaderboard_id or event_leaderboard_id required)

Leaderboard ID (see table above)

event_leaderboard_id (leaderboard_id or event_leaderboard_id required)

Event Leaderboard ID (see table above)

language (Optional, defaults to en)

Language (see table above)

flag (Optional, defaults to true)

Show player flag

search (search, steam_id or profile_id required)

Name Search, returns the highest rated player

steam_id (search, steam_id or profile_id required)

steamID64 (ex: 76561199003184910)

profile_id (search, steam_id or profile_id required)

Profile ID (ex: 459658)

Example Command

Example Responses

twitchuser: !rank
Nightbot: ashleylynn (1238) Rank #3,783, has played 105 games with a 52% winrate, and a -1 streak
twitchuser: !rank Nili
Nightbot: GL.Nili (1351) Rank #1,059, has played 176 games with a 57% winrate, -2 streak, and 1 drops

Request details about the current or last match

If you give multiple ProfileIds this will get the most recent match. This may be useful if you have multiple accounts.

Request Parameters

game (Required with search)

Game (see table above)

language (Optional, defaults to en)

Language (see table above)

color (Optional, defaults to true)

Show player colors

flag (Optional, defaults to false)

Show player flag

civflag (Optional, defaults to false)

Show civ flag (It seems that needs a subscription to use these subscriber emotes, if you want to use this, gift NightBot a sub to FollowGrubby or let me know some other emotes that will work with nightbot)

search (search or profile_id(s) required)

Name Search, returns the highest rated player

profile_id (profile_id or profile_ids required)

Profile ID (ex: 459658)

profile_ids (profile_id or profile_ids required)

Profile IDs (ex: 459658,199325)

Example Command

Example Responses

twitchuser: !match
Nightbot: ashleylynn (1239) as Mongols -VS- KiWiKaKi (1246) as English playing on King of Hill
twitchuser: !match Nili Not working yet, check back later
Nightbot: GL.Nili (1351) as Rus -VS- Mars (1364) as French playing on Lipany