Melty API Documentation
Welcome to the Melty API documentation. This API provides programmatic access to ADOFAI custom levels data
All API endpoints are accessible via https://api.melty-studios.com.
No authentication is required to access public endpoints. Some administrative endpoints may require authentication via API keys or other methods.
Returns all levels data as a JavaScript module that can be directly imported.
When using /get-levels/js, the response is a JavaScript module with the following structure:
export const comingSoonLevel = { /* level data */ };
export const indieLevels = [ /* array of levels */ ];
export const plcrLevels = [ /* array of levels */ ];
export const legacyLevel = { /* level data */ };
When using /get-levels/json/indie, the response is an JSON array of all the levels data of the specified category. These categories can be chosen from "indie", "plcr", or "comingsoon".
Returns data of a single level in JSON format, determined by the inserted unique ID in the URL.
/get-level-by-id/indie/1 returns an indie level with the ID of 1
/get-level-by-id/plcr/1 returns an Team Polychrome level with the ID of 1
The response is a JSON formatted object with the following structure (using /indie/1 as an example):
{
"type": "indie",
"level": {
"id": 1,
"variation_of": null,
"variation_name": "",
"title": "trung-nova - REFLECTION»«REFRACTION",
"icon": "https://api.tuforums.com/v2/media/image/icon/Q3.png",
"secondary_icon": "https://api.tuforums.com/v2/media/image/icon/U14J.png",
"date": "2025-08-01",
"duration": "3:07",
"bilibili_bvid": "BV1CmhnzfEjF",
"description": "\u003Cp\u003EThis level was made to experiment high keycount rolling patterns and the judgment limiting gimmicks, it is a high-difficulty level.\u003C/p\u003E\u003Cp\u003EThis song was made for COEGTS 2025 Main Mappool NM2.\u003C/p\u003E",
"tuf_link": "https://tuforums.com/levels/9729",
"soundcloud_link": "https://soundcloud.com/trung-nova_727/reflectionrefraction"
}
}