REST API v1

PDF to Markdown API

Convert digital PDFs and scanned PDFs to Markdown programmatically. Built for ingestion pipelines, RAG, and document workflows.

Capabilities

Digital PDF → Markdown

Extract text, tables, and structure from native PDFs with high fidelity

Scanned PDF → Markdown (OCR/Vision)

AI-powered text extraction from image-based PDFs using advanced vision models

Optional metadata output

Page numbers, block coordinates, and confidence scores for downstream QA

Async/batch jobs

Process large files and bulk conversions with job-based workflows

Quickstart

Three examples to get you converting PDFs in minutes

Digital PDF Conversion

Native PDFs with embedded text

POST
curl -X POST https://api.markdownconverters.com/api/v1/convert \
  -H "X-API-Key: your_api_key" \
  -F "file=@document.pdf"

# Response
{
  "success": true,
  "markdown": "# Document Title\n\nContent extracted...",
  "metadata": {
    "pages": 12,
    "format": "pdf"
  }
}

Scanned PDF (OCR/Vision)

Image-based PDFs requiring AI extraction

Pro & above
curl -X POST https://api.markdownconverters.com/api/v1/convert \
  -H "X-API-Key: your_api_key" \
  -F "file=@scanned-contract.pdf" \
  -F "options={\"use_vision\": true}"

# Response
{
  "success": true,
  "markdown": "# Contract Agreement\n\n...",
  "metadata": {
    "pages": 5,
    "ocr_confidence": 0.94,
    "vision_credits_used": 1
  }
}

Async Batch Processing

Multiple files in a single job

Async
# Start batch job
curl -X POST https://api.markdownconverters.com/api/v1/batch \
  -H "X-API-Key: your_api_key" \
  -F "files=@doc1.pdf" \
  -F "files=@doc2.pdf" \
  -F "files=@doc3.pdf"

# Response
{
  "job_id": "batch_abc123",
  "status": "processing",
  "files_queued": 3
}

# Check status
curl https://api.markdownconverters.com/api/v1/batch/batch_abc123/status \
  -H "X-API-Key: your_api_key"

# Response when complete
{
  "job_id": "batch_abc123",
  "status": "completed",
  "results": [
    {"file": "doc1.pdf", "download_url": "..."},
    {"file": "doc2.pdf", "download_url": "..."},
    {"file": "doc3.pdf", "download_url": "..."}
  ]
}

Operational Details

The numbers developers care about

Rate limits

Starter: 500/month • Pro: 5,000/month • Scale: 25,000/month

Requests reset monthly

File size limits

Starter: 100MB • Pro: 1GB • Scale: 2GB

Larger files processed asynchronously

Latency

< 5s for most PDFs

OCR/Vision: 10-30s depending on page count

Retry semantics

Idempotent with job IDs

Safe to retry failed requests without duplicates

Data retention

Auto-deleted within 12 hours

Files purged within 24 hours, never stored long-term

API Pricing

API access included with Starter and Scale plans

Starter

$8.99/mo
  • 500 conversions/month
  • 100MB file size
  • Full API access
Recommended

Scale

$99.99/mo
  • 25000 conversions/month
  • 2GB file size
  • AI Vision OCR (2000 credits/month)
  • Priority processing

Enterprise

Custom
  • Unlimited conversions
  • Custom file size limits
  • Dedicated support + SLA
  • On-prem deployment options

FAQ

Can I embed this in my SaaS?

Yes. Our API is designed for integration into your products. Starter, Pro, and Scale plans include full commercial use rights. For white-label or high-volume use cases, contact us about Enterprise pricing.

Do you offer bulk pricing?

Yes. Enterprise plans include custom rate limits, dedicated support, and volume discounts. Contact our team to discuss your requirements.

What about PII/compliance?

All files are encrypted in transit (TLS 1.3) and at rest. Processing happens in isolated containers, and files are automatically deleted within 12 hours. We never store or analyze your content. GDPR and SOC 2 compliant.

Ready to integrate?

Get your API key and start converting PDFs programmatically in minutes.