API Reference

Build your own ADOFAI tools with the ADOFAI.NET REST API. 20 endpoints across maps, rankings, bookmarks, AI, and auth.

https://adofai.net/api

JSON responses

60 req/min

Public— No authentication needed

Auth Required— Login first via POST /api/auth/login (sets httpOnly cookie)

Admin Only— Requires ADMIN or MODERATOR role

randomRandom order (default)

popularMost liked maps first

trendingTrending by likes + plays + recency

newestMost recently created

difficulty_ascEasiest first

difficulty_descHardest first

bpmHighest BPM first

Maps

Browse, search, and interact with the map database

Global leaderboards and score submissions

Save maps for later

AI-powered analysis and coaching via Pollinations AI (free, no API key)

User authentication via JWT httpOnly cookies

Platform statistics and user profiles

Submit a feature request or contribute to the open-source platform