Document conversion API for Word, Excel, PowerPoint and PDF
Dreep converts documents the way it transforms images: request an uploaded .docx with a .pdf extension and you get a PDF back. To convert a file in one call, POST it to /convert with the format you want and Dreep saves the result as a new asset. Each conversion runs once, then it's cached.
Supported formats
Documents convert within their own family, and any of them converts to PDF. A spreadsheet can't become a Word document.
| Document | Upload | Convert to |
|---|---|---|
| Word | doc, docx, odt, rtf | pdf, docx, odt, rtf |
| Excel | xls, xlsx, ods, csv | pdf, xlsx, ods, csv |
| PowerPoint | ppt, pptx, odp | pdf, pptx, odp |
| docx, or one page as png or jpeg |
How conversion works
Conversion runs in the same delivery pipeline as image and video transformations, so folder access rules, signed URLs and custom domains apply to converted files too.
- 1
Word, Excel, PowerPoint or PDF
Uploaded to Dreep
- 2
Request .pdf
Or ?format=pdf
- 3
First request
Converted, one conversion counted
- 4
Cached result
Stored with your files
- 5
Later requests
Served from cache, not counted
Convert by URL, or in one call
# An uploaded document, as a PDF
curl "https://cdn.dreep.cloud/api/v1/fetch/<assetId>.pdf"
# Page 2 of a PDF, as a PNG
curl "https://cdn.dreep.cloud/api/v1/fetch/<assetId>.png?page=2"
# Upload and convert in one call
curl -X POST "https://api.dreep.cloud/api/v1/convert" \
-H "Authorization: Bearer drp_live_xxxxx" \
-F "file=@contract.docx" \
-F "format=pdf"// An uploaded document, as a PDF
const pdfUrl = `https://cdn.dreep.cloud/api/v1/fetch/${assetId}.pdf`;
// Upload and convert in one call
const body = new FormData();
body.append("file", file);
body.append("format", "pdf");
const response = await fetch("https://api.dreep.cloud/api/v1/convert", {
method: "POST",
headers: { Authorization: "Bearer drp_live_xxxxx" },
body,
});
const { asset } = await response.json();Why convert documents with Dreep
No conversion server to run
Office and PDF conversion needs an office suite, fonts and a queue. Dreep runs them, so you don't install LibreOffice or manage workers.
A URL instead of a job system
Most documents convert in a second or two and come back in the same request. Long ones answer 202 until they're ready.
Converted once, then cached
The first request produces the file. Every later request for the same URL is served from cache and isn't counted.
Access rules carry over
A contract in a Signed folder converts to a PDF that also needs a signed URL.
Frequently asked questions
How is document conversion billed?
Per converted file. Free includes 100 conversions a month, Starter 2,000 and Pro 10,000. Requesting a file that's already been converted is served from cache and doesn't count.
Can I convert a PDF back to an editable Word document?
Yes, on paid plans. Request the PDF with a .docx extension, or POST it to /convert with format=docx. Text, tables and images come back as editable content.
How do I make a thumbnail of a PDF?
Request the PDF with a .png or .jpg extension. Add ?page=3 for another page. The result is an ordinary image you can resize like any other.
What are the limits on the Free plan?
Documents up to 10 MB, PDF output trimmed to the first 5 pages, and page images up to page 5. PDF to Word is available on Starter and Pro.
What happens with a corrupt or password-protected file?
Dreep returns 400 with a message saying the document couldn't be converted. Failed conversions are not counted.
Turn your first Word file into a PDF
Create a free project, upload a .docx and open it with a .pdf extension.