Can I use the Trackmania.io API?

Yes, you are allowed to use the Trackmania.io private API, as long as you understand and follow the following disclaimers:

• Consider whether you can and want to use Nadeo's own API. This reduces stress on Nadeo & Openplanet servers.
• The API is unsupported. If we remove/change something, we will (likely) not give notice of it, and you'll have to deal with the consequences of the change yourself.
• The API is undocumented. You're on your own to figure out how the API works and what you need from it.
• Use a proper user agent header that describes your project or purpose so that we can see who and what is using the API. If you pretend to be a browser, you will be blocked.
• If you're going to make the result of your requests available somewhere, please credit us for your data, preferably using the line Powered by Trackmania.io.
• There is a rate limit of 40 requests per minute (this might still change). Please be respectful of our server resources, as well as Nadeo's. Cache stuff! Please let us know if you're planning to do any kind of "bulk" requests!
• If you need more requests per minute, please contact us to request an API key to raise the limit to 150 requests per minute.
• We have the right to block anyone from using the API if we deem their usage a nuisance. To request an unblock, please contact us.
• Let us know what you're working on! We're always curious and it lets us understand how people are using the API and who to contact about certain things if any contact is needed.

Banned API usage

There's a couple things we do not allow the API to be used for.

• Do not use the API for a "find someone's rank in the leaderboard" app - this creates a lot of requests, and is exactly what the Club Edition of the game is for!
• Anything else which purpose is to work around restrictions in Starter or Standard editions.
• 24/7 monitoring at a very fast rate - this is still allowed, but at a slower rate of at most 1 request per minute.

Questions?

If you're still unsure about your use of the API, feel free to DM @miss on Discord or @codecat@meow.social on Mastodon with any further questions.