PDF Tools API

API web a PDF

Integra convertir páginas web a PDF en tu backend, tareas por lotes o producto sin mantener una infraestructura propia de PDF.

Create API Key Read full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/webpage-to-pdf/pdf

Use your API Key in the x-api-key header.

Use case

Úsalo para capturar páginas públicas, exportaciones de cliente o evidencias web programadas. La herramienta web sirve para revisión manual; la API, para automatización estable del lado servidor.

cURL example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'url=https://example.com/report' \
  -F 'pageSize=A4' \
  -F 'waitDelay=2' \
  --output webpage.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'url=https://example.com/report' \
  -F 'pageSize=A4' \
  -F 'waitDelay=2' \
  --output webpage.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/webpage-to-pdf/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "url": "https://example.com/report",
    "pageSize": "A4",
    "waitDelay": 2
  }' \
  --output webpage.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/webpage-to-pdf/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  url: 'https://example.com/report',
  pageSize: 'A4',
  waitDelay: 2
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('webpage.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/webpage-to-pdf/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'url': 'https://example.com/report',
        'pageSize': 'A4',
        'waitDelay': 2,
    },
)
response.raise_for_status()

with open('webpage.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_payload

El JSON o multipart no incluye el HTML, URL o archivo requerido.

401invalid_api_key

Falta x-api-key, no es válida o fue rotada.

402insufficient_credits

La cuenta no tiene API Credits suficientes.

502conversion_failed

El renderizado del servidor no pudo completar la conversión. Los Credits se devuelven automáticamente si falla.

Limits

Necesita un PDF válido o datos de entrada correctos.
Llama a la API desde el servidor para no exponer tu API Key.
Prueba archivos representativos antes de procesar lotes grandes.

Response headers

webpage.pdf con cabeceras de Credits consumidos y saldo restante.

Content-Type: Tipo MIME del archivo generado, normalmente application/pdf o application/zip.
Content-Disposition: Nombre de descarga del archivo generado.
X-Credits-Charged: Credits cobrados por la solicitud correcta.
X-Credit-Balance: Saldo de API Credits después de la solicitud.

FAQ

¿Cuánto cuesta API web a PDF?

Cada solicitud correcta usa API Credits; si el procesamiento falla, se devuelven automáticamente. Cada usuario con sesión recibe 100 free API Credits al mes, y 1,000 Credits = $1.

¿Las herramientas web usan API Credits?

No. Las herramientas que procesan en el navegador no consumen API Credits. Solo cuentan las solicitudes con API Key.

¿Puedo llamar la API desde el navegador?

No es recomendable. Guarda la API Key en tu backend, cola o automatización del servidor.

Start with 100 free API Credits

Create an API Key, test API web a PDF, and buy more Credits only when automation volume grows.

Get API Key View full API docs