Overview

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.

GitHubGitHub ReportReport an Issue BackBack to Hub HomeBack to Home Page

Authentication

No authentication is required to access public endpoints. Some administrative endpoints may require authentication via API keys or other methods.

Endpoints

Get Levels Data

GET /get-levels

Returns all levels data as a JavaScript module that can be directly imported.

Response Format

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

GET /get-level-by-id

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

Response Format

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"
	}
}
			
© 2025 nuomibinggao • MIT License