ManiaExchange 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 mappacks.

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 guaranteed.

Mappack Information

This method returns information for a single mappack.

https://api.mania-exchange.com/{site}/mappacks/{ids,}/?={secret}
Parameter Description
id The Mappack ID.
secret Used for unreleased mappacks. Like a password for secret testing.

Get Mappack Tracks

Get the tracks of a mappack.

https://api.mania-exchange.com/tm/mappack/{ID}/tracks/?={secret}
Parameter Description
ID The mappack ID.
secret Used for unreleased mappacks. Like a password for secret testing.

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/mappack for a ManiaPlanet server, you can optionally set the X-ManiaPlanet-ServerLogin header to the server login string.

Mappack Download

Returns a zip file with all approved tracks inside the associated mappack ID.

https://{site}.mania-exchange.com/mappack/download/{id}?{param}
Parameter Description
id The mappack ID. Providing an invalid ID will cause a redirect to the sites homepage.
secret Used for unreleased mappacks. Like a password for secret testing.

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

Latest Mappacks

Returns the 10 most recently created mappacks.

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

https://api.mania-exchange.com/{site}/mappacks/list/latest
Parameter Description
titlepack The Titlepack name (without everything after the @).

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.

Track 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.

Mappack thumbnail

Returns the custom thumbnail (400x400) for the specified mappack. If no thumbnail has been uploaded, a standard image will be displayed.

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