API Documentation
FileCraft REST API lets you integrate file processing into your own systems. Available on Pro, Business, and Enterprise plans.
Base URL
Authentication
All requests require an API key passed in the Authorization header.
# All requests require this header
Authorization: Bearer YOUR_API_KEY
Get your API key from the account dashboard. Enterprise customers can generate multiple keys per team.
Endpoints
/api/process/compress-pdfCompress a PDF file
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| file | File | ✓ | The PDF file to compress |
| quality | string | — | "low" | "medium" | "high". Default: "medium" |
Response: Binary PDF blob with X-Size-Before, X-Size-After, X-Reduction headers
/api/process/compress-imageCompress a JPEG, PNG, or WebP image
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| file | File | ✓ | The image file to compress |
| quality | number | — | Quality 1–100. Default: 80 |
| format | string | — | "jpeg" | "png" | "webp". Default: same as input |
Response: Binary image blob with X-Size-Before, X-Size-After headers
/api/process/merge-pdfMerge multiple PDFs into one
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| file0, file1, … | File | ✓ | PDFs to merge, in order |
Response: Binary merged PDF blob
Code Example
# Compress a PDF with curl
curl -X POST https://api.filecraft.tools/v1/compress-pdf \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "[email protected]" \
-F "quality=medium" \
--output compressed.pdf
# JavaScript / Node.js
const form = new FormData()
form.append('file', fs.createReadStream('document.pdf'))
form.append('quality', 'medium')
const res = await fetch(
'https://api.filecraft.tools/v1/compress-pdf',
{ method: 'POST', headers: { Authorization: `Bearer ${API_KEY}` }, body: form }
)
const blob = await res.blob()
Rate Limits
| Plan | Limit | Notes |
|---|---|---|
| Free | — | API access not available on Free plan |
| Pro | 100 req/hour | Up to 500MB per file |
| Business | 1,000 req/hour | Up to 2GB per file |
| Enterprise | Unlimited | Custom file size limits |
Need higher limits or custom integration support?
Talk to Enterprise Sales →