API de PDF
No hace falta clave de API, cuenta ni registro para combinar, comprimir, dividir, rotar, convertir o aplicar OCR a un PDF. Combina, comprime, divide, rota, convierte y aplica OCR a PDF por HTTP simple. Envía un archivo, obtén un id y descarga el resultado.
Última actualización: 1 de septiembre de 2026
Este es el mismo motor que Sitio web de ScanReviver funciona con. Es gratis realizar llamadas dentro de los límites indicados, y no es necesario registrarse.
Cómo funciona una llamada
Cada tarea consta de dos pasos. Tú POST su archivo y conseguir un pequeño objeto JSON de vuelta con un idLuego GET el resultado usando ese id. La razón de la división es que un trabajo puede producir más de una salida: un PDF fusionado, una sola página o un ZIP de imágenes.
# step 1: send two PDFs to be merged
$ curl -s -F "files=@a.pdf" -F "files=@b.pdf" \
https://scanreviver.com/api/pdf-merge
{"id":"5ea56646f09146979eabc2faecd0f889","bytes":72597,"files":2}
# step 2: download the merged file
$ curl -s -o merged.pdf \
https://scanreviver.com/api/pdf-file/5ea56646f09146979eabc2faecd0f889Endpoints
Todos estos toman multipart/form-data y devuelve un archivo JSON que contiene id.
| Endpoint | Enviar | Luego, obtener de |
|---|---|---|
POST /api/pdf-merge | files, un campo repetido por PDF | /api/pdf-file/{id} |
POST /api/pdf-compress | file, más level (good por defecto) | /api/pdf-file/{id} |
POST /api/pdf-split | file | /api/pdf-split-file/{id} |
POST /api/pdf-to-images | file | /api/pdf-zip/{id}, o una página a la vez desde /api/pdf-page/{id}/{n} |
POST /api/pdf-to-word | file | /api/pdf-word/{id} |
POST /api/pdf-to-excel | file | /api/pdf-excel/{id} |
POST /api/pdf-to-ppt | file | /api/pdf-ppt/{id} |
POST /api/ocr-text | file | nada; el texto se devuelve en la misma respuesta |
El sitio web ofrece más funciones que las que se mencionan aquí, incluyendo opciones para rotar, recortar, añadir números de página, insertar marcas de agua, crear formularios y añadir firmas. Todas estas funciones siguen el mismo proceso de dos pasos. Si necesitas alguna otra función que no esté incluida en la lista, puedes solicitarla en el página de contacto y lo documentaremos correctamente en lugar de dejarte adivinar.
OCR devuelve el texto directamente
/api/ocr-text es el que no necesita una segunda llamada, porque el resultado es texto en lugar de un archivo:
$ curl -s -F "file=@invoice.pdf" https://scanreviver.com/api/ocr-text
{"text":"Invoice 2026 total 42 euro","pages":1,"total_pages":1,"chars":26}Límites
| Máximo por archivo | 250 MB (de PDF a PowerPoint: 25 MB) |
|---|---|
| Máximo por tarea | 1000 MB |
| Páginas por PDF | 25 (el OCR lee los primeros 15) |
| Trabajos simultáneos. | Por favor, mantén solo 1 a la vez (no obligatorio) |
| Tareas por día. | Sin límite |
| El resultado permanece disponible | 45 minutos |
Los 45 minutos son importantes: descarga el resultado en la misma ejecución de tu script. Un id que guardaste ayer no funcionará, y esto es intencional: nada tuyo se queda en nuestro disco más tiempo del necesario.
Errores
Los errores se devuelven como JSON, no como un archivo, así que comprueba el código de estado antes de escribir el cuerpo en cualquier lugar.
| Estado | Significado |
|---|---|
400 | El archivo no se puede utilizar para esta operación, o el ID de la tarea es desconocido o tiene más de 45 minutos de antigüedad. El mensaje indica cuál es el problema. |
413 | Demasiado grande o demasiadas páginas. |
422 | Falta un campo obligatorio del formulario. |
429 | Ya tienes una tarea en ejecución desde esta dirección. |
Una utilidad práctica: enviar un PDF escaneado al convertidor de Word genera un 400 le dice que ejecute OCR primero, porque no hay texto real en el archivo para convertir.
Python, de principio a fin
import requests
BASE = "https://scanreviver.com"
r = requests.post(f"{BASE}/api/pdf-merge",
files=[("files", open("a.pdf", "rb")),
("files", open("b.pdf", "rb"))],
timeout=180)
r.raise_for_status()
job = r.json()["id"]
out = requests.get(f"{BASE}/api/pdf-file/{job}", timeout=180)
out.raise_for_status()
open("merged.pdf", "wb").write(out.content)Usándolo en tu propio proyecto
Puedes utilizarlo como base y, si lo deseas, incluirlo en algún proyecto de pago. Te pedimos dos cosas, aunque no son obligatorias: envía una sola tarea a la vez para que todos tengan su turno, y si tu proyecto incluye una lista de los recursos que utiliza, incluye un enlace a scanreviver.comEso es lo que mantiene esto libre.
¿Estás planeando una campaña de gran envergadura? ¡Conéctate con nosotros en el página de contacto Primero, preferimos que nos cuentes lo que necesitas antes de imponerte restricciones.
Preguntas
¿Necesito una clave API?
No. No hay clave, ni cuenta, ni necesidad de registrarse: simplemente envía tu archivo al endpoint que necesites y recibirás un ID de tarea.
¿Qué es una API de PDF?
Una API que te permite enviar un archivo PDF a través de HTTP y recibir un resultado, como un archivo comprimido, texto extraído o un documento convertido. No se necesita un navegador; funciona desde cualquier script o aplicación.
¿Puedo procesar archivos PDF de forma programática?
Sí. Envía un archivo al endpoint, obtén un ID de tarea y recupera el resultado con una segunda solicitud. Funciona con curl, Python, Node.js o cualquier lenguaje que pueda realizar llamadas HTTP.
¿Existe una API de PDF gratuita?
Sí. Esta API no requiere clave, ni cuenta, ni tiene un límite diario de uso. Los archivos pueden tener hasta 250 MB y 25 páginas por PDF, con dos excepciones: la conversión de PDF a PowerPoint admite archivos de hasta 25 MB, y el endpoint de OCR lee hasta 15 páginas.
¿Cómo puedo convertir un PDF a través de la API?
Envía el archivo al endpoint correspondiente, como /api/pdf-to-word, y recupera el resultado de la ruta de descarga que le corresponde. La tabla de endpoints de esta página enumera todas las conversiones disponibles.
¿Por qué devuelve un ID en lugar del archivo?
El procesamiento de archivos PDF puede generar varios resultados a partir de un solo trabajo, como un rango de páginas o un archivo ZIP completo. La solicitud POST devuelve un ID de trabajo y una segunda solicitud GET recupera el resultado deseado. La combinación y compresión devuelven el PDF desde /api/pdf-file/{id}.
¿Cuánto tiempo está disponible el resultado?
45 minutos. Después de eso, el ID del trabajo deja de funcionar y el archivo desaparece, así que descárgalo en la misma ejecución del script en lugar de guardar el ID para más adelante.
¿Existe un límite diario?
No. No hay un límite diario ni una cuota por clave. El servidor procesa varias solicitudes a la vez, por lo que, en momentos de gran demanda, una solicitud puede tardar un poco más; por favor, envía una solicitud a la vez.
¿El pase de pago modifica los límites de la API?
El pase aumenta el tamaño de los archivos y el número de páginas del sitio web. Considere los números que aparecen en esta página como los resultados que obtendría sin utilizar la herramienta.
¿Puede leer un PDF escaneado?
Sí, a través del endpoint de OCR, que devuelve el texto reconocido como JSON. Los convertidores de Word y Excel necesitan un PDF que ya contenga texto real y te lo indicarán si no es así.