Developer REST API

Integrate ByteConverter directly into your applications, microservices, and CI/CD pipelines.

1. Authentication & Rate Limits

All developer API requests require an API key passed in the standard Authorization header using the Bearer scheme. You can create and manage API keys inside your Dashboard. Keys follow the format byteconvert-<38 characters>.

Authorization: Bearer byteconvert-9a8B7c6D5e4F3g2H1i0J...

Tier Rate Limits (Rolling 2-Minute Window)

Free / Normal Tier: 20 requests per 2 minutes
Premium Tier: 100 requests per 2 minutes

Rate-limited requests return HTTP 429 Too Many Requests with standard X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After headers.

POST/api/v1/jobs

Uploads a file and enqueues a new conversion job. Expects multipart/form-data with file and targetFormat.

cURL Example

curl -X POST https://byteconverter.com/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "targetFormat=mp3"

Node.js (Fetch) Example

import fs from 'fs';

const form = new FormData();
form.append('file', new Blob([fs.readFileSync('image.png')]), 'image.png');
form.append('targetFormat', 'webp');

const res = await fetch('https://byteconverter.com/api/v1/jobs', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.BYTE_API_KEY,
  },
  body: form,
});

const data = await res.json();
console.log('Download URL:', data.item.downloadUrl);

GET/api/v1/usage

Returns current daily conversion quota, remaining conversions before 00:00 UTC reset, and storage byte accounting.