API v2

This content applies to version 2.5.0 and newer versions of the Tracker.

If you cannot find what you're looking for, check the API v1 documentation page.

Each of the following API paths has its own associated schema. All API v2 paths are under the /api/v2 route, have cross-origin enabled, accept GET parameters, and return JSON. In addition, any API call can return status 404 (not found), status 500 (internal server error), or 400 (bad request), which may be accompanied by an "error" object in the response describing the error.

Most schemas below reference this schema.

/api/v2/servers

Returns a list of all servers online. [schema]

Example (link):

http://sauertracker.net/api/v2/servers

/api/v2/server/:host/:port

Returns a single server along with the game info. [schema]

Example (link):

http://sauertracker.net/api/v2/server/144.76.176.131/28785

/api/v2/games/find

Returns a list of games that match a given query, sorted descendingly by id (timestamp). Also returns the total number of matches, the maximum, and the minimum game ID. [schema]

Example (link):

http://sauertracker.net/api/v2/games/find?host=144.76.176.131&port=28785&todate=2015-09-25

/api/v2/game/:id

Returns a single saved game. [schema]

Example (link):

http://sauertracker.net/api/v2/game/142298

/api/v2/players/find

Returns a list of up to 200 players matching a given name and country, sorted descendingly by frags. Parameters left empty will be ignored. Set country to __ (2 underscores) for Unknown. [schema]

Example (link):

http://sauertracker.net/api/v2/players/find?name=named&country=US

/api/v2/player/:name

Returns info of the player with the given name. [schema]

Example (link):

http://sauertracker.net/api/v2/player/Nix

/api/v2/clans

Returns a list of all clans and their info, sorted by rank. [schema]

Example (link):

http://sauertracker.net/api/v2/clans