API Documentation

Base URL: https://api.uncensorify.space/v1

Authentication

POST /v1/auth/telegram
Authorization: Bearer <access_token>  # all protected routes
POST /v1/auth/refresh { "refresh_token": "..." }
POST/v1/auth/telegramTelegram Login Widget → JWT pair
POST/v1/auth/refreshRotate access + refresh tokens
GET/v1/search?q=Search tracks (auth required)
POST/v1/downloadsRequest download / instant file_id
POST/v1/downloads/batchBatch download (Premium, max 20)
GET/v1/favoritesList favorites
GET/v1/playlistsList user playlists
POST/v1/playlistsCreate playlist
POST/v1/playlists/{id}/tracksAdd track to playlist
GET/v1/subscriptionCurrent subscription status
POST/v1/subscription/checkoutUSDT / TON / Lightning checkout
GET/v1/statusPublic platform health (no auth)

Full OpenAPI spec: openapi.yaml · Status