jpg.now API
Convert images and documents programmatically using the jpg.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://jpg.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. jpg-to-png |
quality | No | Output quality 10–100 (default 90) |
width / height | No | Resize output in pixels |
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://jpg.now/api/v1/convert \
-H "X-Api-Key: YOUR_API_KEY" \
-F "[email protected]" \
-F "slug=jpg-to-png"
# Returns: {"job_id":"abc123","status":"queued","poll_url":"/api/v1/jobs/abc123"}
curl https://jpg.now/api/v1/jobs/abc123 \
-H "X-Api-Key: YOUR_API_KEY"
# Returns: {"status":"completed","download_url":"/download/abc123"}
curl -L https://jpg.now/download/abc123 -o converted.png