API / REST REFERENCE

REST API

The Phaser backend speaks plain JSON over HTTPS. Base URL: https://api.phaser.stream/v1

Public endpoints

GET/v1/tracksPublic

List tracks. Supports sort, genre, limit, cursor.

GET/v1/tracks/:idPublic

Fetch a single track.

GET/v1/artistsPublic

List artists.

GET/v1/search?q=<q>Public

Fuzzy search across tracks, artists, albums.

GET/v1/stream/:trackId/playlist.m3u8Public

HLS master playlist.

POST/v1/auth/noncePublic

Request a nonce to sign.

POST/v1/auth/verifyPublic

Submit { address, signature, message }. Returns { token, expiresAt }.

GET/v1/meJWT

Current user info.

GET/v1/me/likesJWT

Liked tracks.

POST/v1/me/likes/:trackIdJWT

Like a track.

DELETE/v1/me/likes/:trackIdJWT

Unlike a track.

POST/v1/studio/releasesArtist JWT

Initiate a release; returns presigned S3 URL.

PUT/v1/studio/releases/:id/publishArtist JWT

Publish a release.

GET/v1/studio/analyticsArtist JWT

Streams, earnings, top tracks.