Mania Exchange API Reference

The API reference below lists all available API methods.
The common {site} parameter can be either tm or sm and is omitted for each API call.
While for the search API you can specify a {format} parameter (json (default) or xml), other API calls simply use derive this value from the set MIME-type (application/json or application/xml).

Track Information

This method returns information for a collection of requested tracks.

You can request information for a maximum of 50 tracks.

You must specify the UID or track ID in your request (you cannot use both in one request).

https://api.mania-exchange.com/{site}/maps/{ids,}
Parameter Description
ids Track ID or track UID. This can be a string or integer value. Track IDs and track UIDs can be mixed in a single request. Return order is not garantueerd.

Track Download

Returns the raw track file associated with the given id.

https://{site}.mania-exchange.com/tracks/download/{id}
Parameter Description
id The track ID. Providing an invalid ID will cause a redirect to the sites homepage.

Providing a server login

If the request is made to download the track for a ManiaPlanet server, you can optionally set the X-ManiaPlanet-ServerLogin header to the server login string.

Latest Tracks

Returns the 10 most recently uploaded tracks.

Deprecated. - Use the mode-parameter of the search API instead.

https://api.mania-exchange.com/{site}/tracks/list/latest

World Record

Returns world record for the specified track.

https://api.mania-exchange.com/{site}/tracks/worldrecord/{id}
Parameter Description
id The track ID.

Get Replays

Gets a collection of replays for the specified track.

https://api.mania-exchange.com/{site}/replays/{id}/{amount?}
Parameter Description
id Track ID.
amount The amount of records to return. 25 (max, default).

Get Embedded Objects

Gets a collection of embedded objects for the specified track.

https://api.mania-exchange.com/{site}/tracks/embeddedobjects/{id}
Parameter Description
id Track ID.

Screenshot

Returns the custom screenshot for the specified track. If no screenshot has been uploaded, the extracted file thumbnail will be displayed.

https://{site}.mania-exchange.com/tracks/screenshot/{type}/{id}
Parameter Description
id The track ID.
type Value indicating the size of the screenshot. Options available: normal or small. Note that if the track has no custom screenshot, no small variant is generated.

Thumbnail

Returns the thumbnail extracted from the uploaded track file.

https://{site}.mania-exchange.com/tracks/thumbnail/{id}
Parameter Description
id The track ID.