mp3.now API
Convert audio and video programmatically using the mp3.now REST API. API access requires an account - Get your secret key from your Dashboard → API Access page.
Authentication
Pass your API key in the X-Api-Key header on every request.
Base URL
https://mp3.now
Endpoints
POST/api/v1/convert
Submit a file for conversion. Send as multipart/form-data.
| Field | Required | Description |
|---|---|---|
file | Yes | The file to convert |
slug | Yes | Converter ID - E.g. wav-to-mp3 |
bitrate | No | Output bitrate in kbps - E.g. 128, 192, 320 (default 192) |
sample_rate / channels | No | Hz (e.g. 44100) and 1 (mono) or 2 (stereo) |
Returns 202 with {"job_id": "…", "status": "queued", "poll_url": "/api/v1/jobs/…"}
GET/api/v1/jobs/{job_id}
Poll job status. When status is "completed" a download_url is included.
GET/download/{job_id}
Download the converted file. Returns the binary directly.
Quick example (cURL)
curl -X POST https://mp3.now/api/v1/convert \
-H "X-Api-Key: YOUR_API_KEY" \
-F "[email protected]" \
-F "slug=wav-to-mp3"
# Returns: {"job_id":"abc123","status":"queued","poll_url":"/api/v1/jobs/abc123"}
curl https://mp3.now/api/v1/jobs/abc123 \
-H "X-Api-Key: YOUR_API_KEY"
# Returns: {"status":"completed","download_url":"/download/abc123"}
curl -L https://mp3.now/download/abc123 -o converted.mp3