Comprimir PDF
Comprimir PDF es una API que reduce el tamaño de un PDF recomprimiendo las fotos que lleva dentro (lo que normalmente más pesa en un PDF escaneado o con imágenes), sin tocar el texto.
Cómo funciona
Le mandas el PDF y un nivel de calidad, y te lo devuelve con sus imágenes JPEG recomprimidas a ese nivel. El texto, las fuentes y la estructura del documento no se tocan.
Aviso honesto: solo recomprime imágenes guardadas como JPEG dentro del PDF (con diferencia, el caso más común). Otros formatos internos de imagen menos habituales se dejan tal cual. Si el PDF ya está muy comprimido o no lleva fotos, puede que el resultado no encoja mucho, o nada: en ese caso te devolvemos el original, nunca algo que en realidad pese más.
Lo único que necesitas
- Tu API key. La creas en tu panel con "+ Crear llave".
- En tu plataforma de automatización, un paso de tipo "HTTP Request" (n8n, Make, Zapier, Pipedream…).
Cómo usarlo en n8n
- Method:
POST· URL:https://api.cofferdock.com/pdf-compress - Send Headers:
x-api-key= tu llave - Send Body: archivo binario (en n8n: "n8n Binary File")
- En Options → Response → Response Format: elige File
Opciones
| Opción | Por defecto | Para qué sirve |
|---|---|---|
quality | 50 | 10 (más pequeño, más pérdida) a 90 (más grande, casi sin pérdida). |
Resumen de la API
- Endpoint:
POST https://api.cofferdock.com/pdf-compress - Auth: cabecera
x-api-key: TU_LLAVE. - Entrada: PDF a pelo, o JSON
{ file, quality, ... }. - Cómo comprime: encuentra cada imagen JPEG incrustada (
/DCTDecode) en los recursos de cada página y la recodifica a la calidad pedida con sharp/mozjpeg. No toca imágenes en otros formatos internos, ni texto, ni fuentes. - Límites: 20 peticiones/min por IP. 1 llamada = 1 crédito.
Opciones
| Opción | Por defecto | Descripción |
|---|---|---|
quality | 50 | 10–90. Solo afecta a las imágenes JPEG internas. |
Ejemplo
curl -X POST "https://api.cofferdock.com/pdf-compress?quality=40" \
-H "x-api-key: TU_LLAVE" -H "Content-Type: application/pdf" \
--data-binary @grande.pdf \
--output comprimido.pdf
Respuesta
{ "success": true, "pdf": "JVBERi0xLjQK...", "mime_type": "application/pdf",
"meta": { "images_compressed": 3, "original_size_bytes": 2400000,
"size_bytes": 620000, "reduction_percent": 74, "used": 12, "remaining": 488 } }
Lo que recibes
meta.reduction_percent te dice cuánto encogió de verdad. Por defecto: con el PDF a pelo devuelve el PDF directo; con JSON devuelve base64.