PDF Tools API

API para recortar PDF

Integra recortar 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/pdf-tools/crop-pdf

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

Use case

Úsalo para limpiar márgenes de escáner, bordes blancos y áreas visibles inconsistentes. 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/pdf-tools/crop-pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"margin":36}' \
  --output cropped.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/crop-pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"margin":36}' \
  --output cropped.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/crop-pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"margin":36}
  }' \
  --output cropped.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/crop-pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  file: { name: 'input.pdf', dataBase64: 'JVBERi0xLjcK...' },
  options: {"margin":36}
})
});

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

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

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/crop-pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'margin': 36}
    },
)
response.raise_for_status()

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

Error codes

401invalid_api_key

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

402insufficient_credits

La cuenta no tiene API Credits suficientes.

422pdf_tool_processing_failed

No se pudo procesar el archivo, las opciones o la estructura del PDF. 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

cropped.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 para recortar 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 para recortar PDF, and buy more Credits only when automation volume grows.

Get API Key View full API docs