Get TOTDs/Royal maps

Audience: NadeoLiveServices

GET https://live-services.trackmania.nadeo.live/api/token/campaign/month?length={length}&offset={offset}&royal={royal}

Query parameters:

  • {length} (integer) The number of months to retrieve *
  • {offset} (integer) The number of months to skip (looking backwards from the current month) *
  • {royal} (boolean) Whether to return maps for the Royal mode instead of TOTDs

Gets Tracks of the Day (or Royal maps) by month.


Example request:

GET https://live-services.trackmania.nadeo.live/api/token/campaign/month?offset=7&length=1

Example response:

{
  "monthList": [
    {
      "year": 2021,
      "month": 12,
      "lastDay": 31,
      "days": [
        {
          "campaignId": 18255,
          "mapUid": "CFI34MJLLF0M88pCmn1WHTSd6K9",
          "day": 2,
          "monthDay": 1,
          "seasonUid": "ee58b4e5-a7f0-41de-a8dd-e4744b009ab2",
          "leaderboardGroup": null,
          "startTimestamp": 1638381600,
          "endTimestamp": 1638468000,
          "relativeStart": -20469159,
          "relativeEnd": -20382759
        },
        ...
        {
          "campaignId": 18865,
          "mapUid": "mijbrgeyRo6XyjlulEE6QhZSQNm",
          "day": 4,
          "monthDay": 31,
          "seasonUid": "90769a06-30f6-4980-83eb-b046e15c111b",
          "leaderboardGroup": null,
          "startTimestamp": 1640973600,
          "endTimestamp": 1641060000,
          "relativeStart": -17877159,
          "relativeEnd": -17790759
        }
      ],
      "media": {
        "buttonBackgroundUrl": "",
        "buttonForegroundUrl": "",
        "decalUrl": "",
        "popUpBackgroundUrl": "",
        "popUpImageUrl": "",
        "liveButtonBackgroundUrl": "",
        "liveButtonForegroundUrl": ""
      }
    }
  ],
  "itemCount": 25,
  "nextRequestTimestamp": 1658854800,
  "relativeNextRequest": 4041
}

If the month does not exist, the response will show an empty list:

{
  "monthList": [

  ],
  "itemCount": 26,
  "nextRequestTimestamp": 1661274000,
  "relativeNextRequest": 77366
}