MaraDocs API
Document Processing via MaraDocs API
Use the powerful features of the MaraDocs API in your own applications and automations.
Document Intelligence
All features available via API
Recognize documents in images
Extract documents from images
Optimize PDF
Combine / split PDFs
Repair PDFs
AI text recognition on images and PDFs
Extract text
Extract email attachments
Virus scan on all files
Modern SDKs and API Documentation
Developer-first API approach
We offer clean and well-documented SDKs in Typescript and Python. Processing documents via the MaraDocs API is incredibly easy.
The entire API is documented as an OpenAPI Specification.
API Documentation1import { MaraDocsServer, MaraDocsClient } from "@maramia/maradocs-sdk-ts";23// Server-side: create workspace and send workspaceSecret to client4const server = new MaraDocsServer({ secretKey: process.env.MARADOCS_SECRET_KEY! });5const ws = await server.workspace.create({});67// Client-side: OCR documents and combine into single PDF8const client = new MaraDocsClient({ workspaceSecret: ws.workspace_secret });910// Convienient end-to-end flows ready to use11const imgPdf = await client.flow.ocrImg(imageFile); // image → searchable PDF12const pdfPdf = await client.flow.ocrPdf(pdfFile); // PDF → searchable PDF1314// Combine and download your final PDF15const combined = await client.pdf.compose({ pdfs: [{ pdf_handle: imgPdf }, { pdf_handle: pdfPdf }] });16const blob = await client.data.downloadPdf({ pdf_handle: combined.pdf_handle });17
Flexible Billing
Credit-based pricing
Purchase credit packages in advance and use them flexibly for all API functions.
Price calculator
We offer volume-discounted credit prices.
Pricing Overview
Credit consumption per API call
| Function | Unit | Credits |
|---|---|---|
| File upload | per MB | 25 |
| MIME type recognition | per file | 100 |
| Virus scan | per MB | 25 |
| File download | per MB | 25 |
| Validate image | per MB | 25 |
| Create thumbnail | per image | 25 |
| Recognize documents in images | per image | 500 |
| Detect image orientation | per image | 100 |
| Crop image | per section | 25 |
| Rotate image | per image | 25 |
| Convert image to JPEG | per image | 25 |
| Convert image to PNG | per image | 25 |
| Convert image to PDF | per image | 25 |
| Image OCR to PDF | per image | 100 |
| Validate PDF | per MB | 25 |
| Compose PDF | per page | 25 |
| Optimize PDF | per page | 25 |
| Rotate PDF | per page | 25 |
| Render PDF | per page | 25 |
| Detect PDF orientation | per page | 100 |
| PDF OCR (text recognition) | per page | 100 |
| Validate email | per MB | 25 |
The displayed credit costs apply per unit. When processing multiple pages or documents, credits are multiplied accordingly.
Use Cases
Example workflows
Contact us for detailed examples of integration into your workflows. We are happy to provide information on API integration, custom pricing, or technical questions.
Process email attachments
Automate the processing of incoming documents directly after email receipt.
N8N / Make Integration
Integrate MaraDocs into your existing N8N or Make workflow for seamless automation.
Cloud Storage Sync
Process documents automatically when uploading to your cloud storage.
Ready for integration?
After free registration, you can activate your API account in the MaraDocs settings. We will immediately provide you with a sufficient amount of tokens for testing.
Important Notes
How billing works
After purchasing credits, you can use them via our REST API. Each API call consumes the number of credits specified in the price list.
Your credit balance can be topped up at any time. You will receive detailed usage statistics in your dashboard.
Security and Privacy
All API communication is encrypted via HTTPS. Your documents are immediately deleted from our servers after processing.
We offer individual data processing agreements for API usage upon request.
Terms and Conditions
Our Terms and Conditions and the Privacy Policy.