POST /convert/from-url

Converts a document from a signed URL. This is the recommended path for large files and for documents already stored in S3, R2, Supabase Storage, GCS, Azure Blob, or another storage service that can generate short-lived HTTPS URLs.

JSON body

{
  "url": "https://storage.example.com/signed/report.pdf",
  "filename": "report.pdf",
  "input_format": "auto",
  "mode": "fast",
  "clean": true,
  "response_format": "markdown"
}

string

required

Short-lived signed HTTPS URL for the source document.

string

default:"document.pdf"

Document name. It helps detect the format.

enum

default:"auto"

pdf, docx, csv, txt, html, xlsx, pptx, zip, or auto.

enum

default:"fast"

fast, balanced, quality, or auto. See Modes.

boolean

default:"true"

Clean up the output Markdown.

enum

default:"markdown"

markdown or json.

string

Pre-signed PUT URL from your storage. If provided, the API uploads the converted Markdown there and responds with a small JSON body.

enum

default:"identity"

Compression for Markdown uploaded to output_url: identity, gzip, or zstd.

Size: no raw upload limit

Unlike /convert/raw, from-url does not require your app server to send the full file body. The API downloads the document directly from your signed URL, which is better for large files and serverless apps.

Examples

curl -X POST "https://api.markpdf.tech/convert/from-url" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d @payload.json

curl -X POST "https://api.markpdf.tech/convert/from-url?url=https%3A%2F%2Fstorage.example.com%2Fsigned.pdf&filename=report.pdf" \
  -H "x-api-key: YOUR_API_KEY"

import httpx

r = httpx.post(
    "https://api.markpdf.tech/convert/from-url",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "url": "https://storage.example.com/signed/report.pdf",
        "filename": "report.pdf",
        "mode": "fast",
    },
    timeout=300,
)
print(r.text)

If a parameter arrives through query and body at the same time, the query parameter wins. See Parameters.

Security

Always use short-lived signed HTTPS URLs. The API rejects unsafe targets such as private network addresses, loopback hosts, credentials embedded in URLs, and non-standard destinations.

​POST /convert/from-url

​JSON body

​Size: no raw upload limit

​Examples

​Security

POST /convert/from-url

JSON body

Size: no raw upload limit

Examples

Security