crisper logocrisper logo

crisper

Free Music API
v1.0.0 Public APIHigh-Fidelity Audio Core48h tmpfiles CDNFree • Zero Auth

Developer API Reference

One single, clean endpoint for song search, synchronous download, and real-time 5-stage progress streaming.

Endpointhttps://crisper.onrender.com/api/v1/audio

How It Works (3 Modes on 1 Endpoint)

Pass your input in the input parameter. Add &stream=true if you want real-time progress events:

1. Search Mode

Search Songs

Pass a song name. Returns top 8 matching YouTube results with IDs and metadata.

GET /api/v1/audio?input=Faded Alan Walker
2. Direct Mode

Master & Download

Pass a video link or ID. Runs all 5 stages and returns the 48h tmpfiles download link JSON.

GET /api/v1/audio?input=60ItHLz5WEA
3. Live Stream

5-Stage Progress (SSE)

Add &stream=true to stream live real-time progress events for each stage.

GET /api/v1/audio?input=60ItHLz5WEA&stream=true

The 5-Stage Audio Processing Pipeline

When a track ID or link is processed, the backend executes this exact 5-stage pipeline:

1

Stage 1: Resolving Source

Validates track ID and extracts audio stream metadata.

2

Stage 2: 320kbps Profile

Configures studio-grade high-fidelity bitrate profile.

3

Stage 3: Mastering Stream

Captures, cleans metadata, and packages the MP3 container.

4

Stage 4: tmpfiles Cloud Upload

Transfers container to tmpfiles.org for 48-hour fast CDN hosting.

5

Stage 5: Cleanup & Return

Deletes server temporary file and returns the direct download link.

Response Schemas

Direct Download Response (200 OK)
{
  "type": "download",
  "success": true,
  "title": "Alan Walker - Faded",
  "filename": "Alan Walker - Faded.mp3",
  "audioId": "60ItHLz5WEA",
  "quality": "320kbps",
  "sizeBytes": 8192000,
  "sizeFormatted": "7.81 MB",
  "downloadUrl": "https://tmpfiles.org/dl/wdwkSwFuQcFs/Alan_Walker_-_Faded.mp3",
  "expiresIn": "48 Hours",
  "uploadedAt": "2026-08-15T18:00:20.123Z"
}
Live Stream Event Stream Format (&stream=true)
data: {"step":1,"stage":"resolving","message":"Resolving audio source..."}

data: {"step":2,"stage":"profiling","message":"Configuring 320kbps high-fidelity profile..."}

data: {"step":3,"stage":"mastering","message":"Packaging and mastering audio stream..."}

data: {"step":4,"stage":"uploading","message":"Uploading container to tmpfiles (48h)..."}

data: {"step":5,"stage":"completed","downloadUrl":"https://tmpfiles.org/dl/wdwkSwFuQcFs/Alan_Walker_-_Faded.mp3"}

Live API Tester

Test queries, direct links, or live SSE streaming right now in your browser:

cURL Quick Examples

1. Search Songs
curl "https://crisper.onrender.com/api/v1/audio?input=Alan+Walker+Faded"
2. Master & Download (One-Shot JSON)
curl "https://crisper.onrender.com/api/v1/audio?input=60ItHLz5WEA"
3. Live 5-Stage Stream (SSE)
curl -N "https://crisper.onrender.com/api/v1/audio?input=60ItHLz5WEA&stream=true"
← Back to Studio Web App