Fablesh Media Catalog API

API, storage and database status.

All catalog artists. Filter with ?q=. Slim rows without track arrays.

One artist with bio, image, Spotify link and all releases.

All releases. Filter with ?type=single|ep|album, ?artist={slug}, ?q=.

One release: tracks, artwork, UPC, label, release date, Spotify link.

All tracks. Filter with ?artist=, ?release=, ?q= (matches ISRC too).

One track: audio URL, ISRC, duration, play count, Spotify link.

Everything in one payload: { artists, releases, tracks }. Aliases: /api/public/catalog/summary, /api/v1/catalog/summary.

Lightweight autocomplete list: name, slug, trackCount.

Algorithmic playlists that grow by themselves: most played, radio favourites, fresh drops, hidden gems, genre mixes, daily mix.

One auto playlist with its current tracks.

Increments the play counter. Called automatically by the web player.

Both broadcast stations and the algorithmic playlists, marked kind: live | playlist.

Now playing, listeners and recent history for Radio Uppsala and Radio Roslagen. Normalised, so no AzuraCast call needed.

The station's tracks, spread so no artist repeats back to back. Order is stable for a day. ?limit= up to 200.

All public shows.

One show with metadata and artwork.

Episodes for a show.

Public RSS feed per show, ready for podcast apps.

Uploaded media assets with metadata and processing status.

One asset including variants and metadata.

The Creator Hub feed. Public read; posting requires sign-in.

Published collaborator profiles.

Services offered by creators.

Presigned PUT URL for direct-to-R2 audio upload.

Registers a finished upload and queues processing.

Imports audio from a source URL.

Multipart image upload (artwork, artist photos) to R2.

Presigned PUT URL for Creator Hub project files (audio, artwork, PDF…).

Name and image.

Title, type, label, release date, UPC, genres, artwork URL.

Title, track number, ISRC, duration.

Removes a release and its tracks. Storage files are kept.

Removes a track; empty releases are removed too.

Removes uploaded duplicates of catalog tracks. Dry run by default; { "apply": true } deletes.

Attaches an uploaded audio file to a catalog track.

Finds an official cover (Deezer) or generates one (AI), stores it in R2.

Title, artist, release, ISRC, artwork URL and more.

Removes the record — audio files stay in storage.

Queues processing for uploaded media.

Queues distribution, e.g. destination radio-uppsala.

Queues radio distribution for a release's tracks.

Creates a show.

Imports an existing show — episodes and artwork included; optional ongoing sync.

Adds an episode. Audio via …/audio/upload-url, then …/process and …/publish.

Re-reads the source feeds and pulls in per-episode images that were missing.

Moves show and episode covers into the image bucket. ?apply=true to write.

Removes audio we used to host; episodes link to the publisher's own file. ?apply=true to write.

Pulls album, single, release, artist and track art hosted elsewhere into fablesh-images. Runs automatically every 30 min; ?apply=true forces a full pass.

Fetches artwork still hosted on the retired Lovable storage. ?apply=true to write.

Finds a cover on Deezer, reuses release art, or generates one with AI. Returns 202 and applies it when done.

Your Creator Hub projects. Create with POST; update/delete on /{id}.

Publishes a feed post. Like via /{id}/like, reply via /{id}/comments.

Radio plays, finished renders, requests. Mark read via POST …/read.

Totals, per station, top tracks and recent plays of your catalog.

Creates or updates your directory profile.

Puts a service up for sale.

Sends an inquiry to another creator. GET lists sent and received.

Job feed over Server-Sent Events. Token as ?token= query parameter.

GDPR export of your account, roles and playlists as JSON.

Permanently removes your account, playlists and roles.

Trail of all write operations (who, what, when, outcome).