ManiaExchange API Reference

The API reference below lists all available API methods.
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).

Important info:

Because of the switch to local API-MGMT, most API calls using the url api.mania-exchange.com are no longer updated and therefore deprecated. Please read the following infos:

TrackmaniaExchange (TMX)

The map and replay exchange for Trackmania®.

trackmania.exchange

ManiaExchange for Trackmania² (TM.MX)

The map and replay exchange for Trackmania² in maniaplanet.

tm.mania.exchange
tm.mania-exchange.com

ManiaExchange for Shootmania (SM.MX)

The map and replay exchange for Shootmania in maniaplanet.

sm.mania.exchange
sm.mania-exchange.com

Map Information

This method returns information for a collection of maps.

You can request information for a maximum of 50 maps.

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

https://{site}/api/maps/get_map_info/multi/{ids,}
https://{site}/api/tracks/get_track_info/multi/{ids,}
DEPRECATED FOR: TM.MX (August 2020), TMX
https://api.mania.exchange/{sitehandle}/maps/{ids,}
https://api.mania.exchange/{sitehandle}/tracks/{ids,}
Parameter Description
ids map ID or map UID. This can be a string or integer value. Map IDs and map UIDs can be mixed in a single request. Return order is not guaranteed.

Get Embedded Objects

Gets a collection of embedded objects for the specified map.

https://{site}/api/maps/embeddedobjects/{ID}
https://{site}/api/tracks/embeddedobjects/{ID}
DEPRECATED FOR: TM.MX, TMX
https://api.mania-exchange.com/{site}/tracks/embeddedobjects/{id}
Parameter Description
id Track ID.

Mappack Information

This method returns information for a single mappack.

https://{site}/api/mappack/get_info/{id}?={secret}
DEPRECATED FOR: TM.MX, TMX
https://api.mania-exchange.com/{sitehandle}/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://{site}/api/mappack/get_mappack_tracks/{ID}?={secret}
DEPRECATED FOR: TM.MX, TMX
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}/maps/download/{id}
https://{site}/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}/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.

Deprecated. - Use the amount-parameter of the get replays API instead.

DEPRECATED FOR: TM.MX, TMX
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, in ascending order.

Select an amount of 1 to return the world record.

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

Seasonal Leaderboard

Returns the seasonal leaderboard for the specified season.

https://{site}/api/leaderboard/season/{SeasonID}
Parameter Description
SeasonID The identifier for the season. Leave empty or specify with 0 to get the current season's information.

Seasonal Leaderboard Stats for User

Returns the seasonal leaderboard stats for the specified season and users.

https://{site}/api/leaderboard/season/{SeasonID}/user/{ids,}
Parameter Description
SeasonID The identifier for the season. Leave empty or specify with 0 to get the current season's information.
ids The UserIDs for the users, comma seperated.

Get Leaderboard Seasons

Returns the available leaderboard seasons.

https://{site}/api/leaderboard/getseasons

Image

Returns the high quality image for the specified map (width is kept original).

https://{site}/maps/{mapid}/image/{image}
Parameter Description
mapid The map ID.
image The image number. Between 0 to 5. Available images are determined by the ImageCount attribute from the map info.

Image Thumb

Returns the image thumbnail for the specified map (width = 600px).

https://{site}/maps/{mapid}/imagethumb/{image}
Parameter Description
mapid The map ID.
image The image number. Between 0 to 5. Available images are determined by the ImageCount attribute from the map info.

Map Screenshot (old)

Returns the (first) custom screenshot for the specified map. If no screenshot has been uploaded, the extracted file thumbnail will be displayed.

https://{site}/maps/screenshot/{type}/{id}
https://{site}/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}/maps/thumbnail/{id}
https://{site}/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}/mappacks/thumbnail/{id}
Parameter Description
id The mappack ID.

Get Tags

Returns the available style tags.

https://{site}/api/tags/gettags