Developer API

The ConvertStream API allows developers to programmatically access our powerful file conversion and optimization engines. Build custom workflows and integrate state-of-the-art tools directly into your applications.

v1.2 Stable99.9% Uptime

Quick Start Guide

1

Get Token

Go to your Profile settings to copy your API Key.

2

Choose Op

Pick an ID like 'merge-pdf' from our tool list.

3

Go Live

Send a POST request with your file and options.

Authentication

All API requests require a Bearer Token obtained via your ConvertStream profile. Include this token in the Authorization header for every request.

Authorization: Bearer <your_api_token>

Core Endpoints

POST

/api/operations

Perform file conversions (PDF, Image, Video, Audio).

GET

/api/profile/usage

Retrieve current usage stats and history.

Available Tool IDs

When calling the /api/operations endpoint, you must specify an operation ID. Below is the full directory of supported tools for the current API version.

Tool NameOperation IDCategory
Merge PDFmerge-pdfPDF
Split PDFsplit-pdfPDF
Compress PDFcompress-pdfPDF
Word to PDFword-to-pdfPDF
Excel to PDFexcel-to-pdfPDF
PDF to Excelpdf-to-excelPDF
Rotate PDFrotate-pdfPDF
Unlock PDFunlock-pdfSecurity
Protect PDFprotect-pdfSecurity
PDF to JPGpdf-to-jpgPDF
HTML to PDFhtml-to-pdfPDF
Text to PDFtxt-to-pdfPDF
JPG to PNGjpg-to-pngImage
PNG to JPGpng-to-jpgImage
WebP to JPGwebp-to-jpgImage
Image to PDFimage-to-pdfImage
Remove Backgroundremove-bgImage
Compress Imagecompress-imageImage
Crop Imagecrop-imageImage
Rotate Imagerotate-imageImage
Flip Imageflip-imageImage
BMP to JPGbmp-to-jpgImage
GIF to JPGgif-to-jpgImage
Video to GIFvideo-to-gifVideo
Mute Videomute-videoVideo
MP4 to AVImp4-to-aviVideo
AVI to MP4avi-to-mp4Video
MKV to MP4mkv-to-mp4Video
Compress Videocompress-videoVideo
Trim Videotrim-videoVideo
Resize Videovideo-resolutionVideo
Change FPSvideo-fpsVideo
Extract Audioextract-audioVideo
Video Thumbnailvideo-thumbnailVideo
MP3 to WAVmp3-to-wavAudio
WAV to MP3wav-to-mp3Audio
FLAC to MP3flac-to-mp3Audio
AAC to MP3aac-to-mp3Audio
OGG to MP3ogg-to-mp3Audio
Compress Audiocompress-audioAudio
Trim Audiotrim-audioAudio
Merge Audiomerge-audioAudio
Normalize Audionormalize-audioAudio
Change Bitratechange-audio-bitrateAudio
Fade In/Outaudio-fadeAudio
JSON to CSVjson-to-csvDocument
CSV to JSONcsv-to-jsonDocument
XML to JSONxml-to-jsonDocument
JSON to XMLjson-to-xmlDocument
YAML to JSONyaml-to-jsonDocument
JSON to YAMLjson-to-yamlDocument
Markdown to HTMLmarkdown-to-htmlDocument
Add Signaturepdf-signaturePDF
PDF Watermarkpdf-watermarkPDF
Resize Imageresize-imageImage
Change DPIimage-dpiImage
Image Watermarkimage-watermarkImage
Image Effectsimage-effectsImage
EXIF Editorimage-exifImage
Video Watermarkvideo-watermarkVideo
Social Downloadersocial-downloaderSocial Downloader
AI PDF Summarizerpdf-summarizerPDF
AI Image Upscalerimage-upscalerImage

Usage Limits

TierRate LimitMax Size
Free Tier60 requests / min100 MB / file
Pro APIUnlimited2 GB / file

Code Example (Node.js)

const response = await fetch('https://convertstream.vercel.app/api/operations', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    },
    body: JSON.stringify({
        operation: 'merge-pdf',
        files: [fileA, fileB],
        options: { optimize: true }
    })
});

const result = await response.json();