MD
PDFtoMarkdown
Cloud API & Webhooks

PDF to Markdown REST API Documentation

Scalable cloud endpoints for high-throughput automated PDF to Markdown conversion with webhooks, strict SLA guarantees, and enterprise security.

100% In-Browser Private
6 min read
Updated September 2026

Test the Core Conversion Engine

100% In-Browser Conversion — Your Files Are Never Uploaded

Drag & Drop your PDF document here

or browse files on your device

⚡ No file size limit 🔒 100% Private
Markdown Output

API Endpoint Overview

POST https://api.pdftomarkdownconverter.net/v1/convert

cURL Request Example

Terminal cURL Authorization: Bearer KEY
curl -X POST https://api.pdftomarkdownconverter.net/v1/convert \
  -H "Authorization: Bearer sec_live_948a2f1b..." \
  -F "file=@quarterly_report.pdf" \
  -F "extract_tables=true" \
  -F "math_delimiters=dollar" \
  -F "webhook_url=https://your-app.com/api/webhooks/pdf"

JSON Response Schema

200 OK application/json
{
  "status": "success",
  "document_id": "doc_8f94a2b1c",
  "pages_processed": 14,
  "execution_time_ms": 142,
  "markdown": "# Quarterly Financial Report\n\n| Metric | Q1 2025 |...\n",
  "token_count": 4820
}

Frequently Asked Questions

Everything you need to know about format extraction, privacy, and markdown compatibility.

What is the maximum file size supported by the Cloud REST API?

The standard REST API endpoint supports multipart uploads up to 250 MB per request. For enterprise workloads exceeding 250 MB, our asynchronous presigned S3/R2 direct ingestion API handles multi-gigabyte document batches.

How does webhook delivery work for long-running batch jobs?

You can provide a `webhook_url` in your POST payload. When processing finishes, our edge workers post a signed HMAC-SHA256 event with `{ status: 'completed', markdown_url: '...', document_id: '...' }` directly to your callback server.

What is the API latency per page?

For standard vector PDFs, average conversion latency is between 8ms and 15ms per page. For full OCR scans, latency averages 120ms per page.

Are API uploads retained or used to train AI models?

Zero retention. All files processed via the API are held in ephemeral in-memory buffers and wiped immediately upon response delivery. Zero customer data is ever stored to disk or used for machine learning training.

Related Conversion Guides & Workflows

Explore dedicated documentation for other document formats and developer pipelines.