API Documentation

Authentication

Include your API key in the X-Api-Key header with every request.

X-Api-Key: tmd_your_api_key_here

Get an API Key

Send a POST request with your email to receive an API key.

curl -X POST https://api.tomdnow.com/api/v1/keys \
  -H "Email: you@example.com"

Response Format:

{
  "api_key": "tmd_abc123...",
  "tier": "free",
  "daily_limit": 50
}

Convert a File

Upload a file with your API key to get Markdown output.

curl -X POST https://api.tomdnow.com/api/v1/convert \
  -H "X-Api-Key: tmd_your_api_key" \
  -F "file=@document.pdf"

Response Format

The API returns a JSON object with the converted Markdown and metadata.

{
  "markdown": "# Document Title\n\nConverted content...",
  "metadata": {
    "title": "document",
    "type": "pdf",
    "size": 102400
  },
  "api_usage": {
    "tier": "free",
    "daily_remaining": 47
  }
}

Rate Limits

API requests are limited per day based on your tier.

Supported Formats

PDF, DOCX, PPTX, XLSX, XLS, HTML, EPUB, CSV, JSON, XML, MSG, IPYNB, ZIP, HWP, HWPX, RTF, TXT, JPG, PNG, GIF, WebP