​

Quickstart

• The URL base of the API.
• A API key (x-api-key). See Authentication.
• A document PDF, DOCX, CSV, XLSX, PPTX, TXT or ZIP.

​

Convert a local file

curl -X POST "https://api.markpdf.tech/convert/raw?filename=report.pdf&mode=fast" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/pdf" \
  --data-binary "@report.pdf"

import httpx

with open("report.pdf", "rb") as fh:
    r = httpx.post(
        "https://api.markpdf.tech/convert/raw",
        params={"filename": "report.pdf", "mode": "fast"},
        headers={"x-api-key": "YOUR_API_KEY", "content-type": "application/pdf"},
        content=fh.read(),
        timeout=300,
    )
print(r.text)

const data = await file.arrayBuffer();
const res = await fetch(
  "https://api.markpdf.tech/convert/raw?filename=report.pdf&mode=fast",
  {
    method: "POST",
    headers: { "x-api-key": "YOUR_API_KEY", "content-type": "application/pdf" },
    body: data,
  },
);
console.log(await res.text());

​

Convert from signed URL

curl -X POST "https://api.markpdf.tech/convert/from-url" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "url": "https://storage.example.com/signed/report.pdf",
    "filename": "report.pdf",
    "mode": "fast"
  }'

​

Convert by uploading the file as a form

curl -X POST "https://api.markpdf.tech/convert?mode=fast" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@report.pdf"

​

Primeros pasos recomendados

1. Starts with mode=fast (this is the default) unless the document has complex tables or irregular layout.
2. Review the response headers (X-Token-Saved-Estimate, X-Conversion-Ms) to understand the real savings in your use case. See Response and headers.
3. If you are converting the same document several times, save ETag and resend with If-None-Match to avoid reconversion. See Cache.
4. If PDF is large and you are only interested in part of it, try POST /pdf/index first before converting the entire document.
5. Handle 202: In high traffic, API can automatically queue your request. The SDK/client must know how to poll /jobs/{id}. See Jobs.

​

Modos

​

Useful headers

​

Common mistakes when starting

• 401: header x-api-key is missing or the key is invavalid. Check Authentication.
• 415: content-type or content-encoding is not a supported one. In /convert/raw only gzip or zstd is accepted as compression.
• 422: in /convert/from-url the field url is missing in the JSON body or in the query.
• 413: The document exceeds the size/page limit. See Weights and limits.

​

Siguiente paso