ES, EN, FR, DE, IT, PT, 繁中, NL, PL, CA, EU, GL, SV, DA, NB, FI, CS, SK, RO, HU, EL, TR, JA, KO

La API de PAPYR

Las mismas herramientas del sitio, desde tu código: envía un archivo por HTTP y recibe el resultado. Sin almacenamiento: procesamos y borramos, como siempre.

Beta cerrada, a propósito

La API se abre por diseño de forma gradual: claves por cuenta (rotables y revocables), límite de ráfaga, cuota mensual y límites de entrada. Está incluida en el plan Pro; si quieres probarla o necesitas volumen, escríbenos y te damos acceso.

Pedir acceso

Autenticación

Cada petición lleva tu clave en la cabecera. La clave se enseña una sola vez al crearla; guárdala en un gestor de secretos. Puedes revocarla en cualquier momento.

Authorization: Bearer papyr_sk_…

Empezar en un minuto

curl -X POST https://www.aim-papyr.ai/api/v1/pdf/merge \
  -H "Authorization: Bearer papyr_sk_TU_CLAVE" \
  -F "files=@informe.pdf" -F "files=@anexo.pdf" \
  -o unido.pdf

Escanear a PDF buscable bash

curl -X POST https://www.aim-papyr.ai/api/v1/pdf/ocr \
  -H "Authorization: Bearer TU_CLAVE" \
  -F "file=@factura.pdf" -F "lang=spa" \
  -o factura-buscable.pdf

Extraer tablas a CSV python

import requests

r = requests.post(
    "https://www.aim-papyr.ai/api/v1/pdf/to-csv",
    headers={"Authorization": "Bearer TU_CLAVE"},
    files={"file": open("facturas.pdf", "rb")},
    data={"sep": ";"}, timeout=120)
r.raise_for_status()
open("facturas.csv", "wb").write(r.content)
print(r.headers["X-Monthly-Used"], "/", r.headers["X-Monthly-Limit"])

PDF a Word desde el navegador javascript

const fd = new FormData();
fd.append("file", archivo);        // File o Blob

const r = await fetch("https://www.aim-papyr.ai/api/v1/pdf/to-word", {
  method: "POST",
  headers: { Authorization: "Bearer TU_CLAVE" },
  body: fd,
});
if (!r.ok) throw new Error((await r.json()).detail);
const docx = await r.blob();

Endpoints (v1)

GET	`/api/v1/me`	Valida tu clave y devuelve plan, cuota usada y límites.
POST	`/api/v1/convert/to-pdf`	Office → PDF — file
POST	`/api/v1/img/compress`	Comprimir imagen — file + quality
POST	`/api/v1/img/convert`	Convertir imagen — file + fmt, quality
POST	`/api/v1/pdf/compress`	Comprimir — file
POST	`/api/v1/pdf/merge`	Unir — files[]
POST	`/api/v1/pdf/ocr`	OCR — file + lang
POST	`/api/v1/pdf/page-numbers`	Numerar — file + position, start
POST	`/api/v1/pdf/protect`	Proteger — file + password
POST	`/api/v1/pdf/rotate`	Rotar — file + degrees
POST	`/api/v1/pdf/split`	Dividir — file + cada
POST	`/api/v1/pdf/to-csv`	PDF → CSV — file + sep
POST	`/api/v1/pdf/to-images`	PDF → imágenes — file + dpi, fmt
POST	`/api/v1/pdf/to-text`	PDF → Texto — file
POST	`/api/v1/pdf/to-word`	PDF → Word — file + lang
POST	`/api/v1/pdf/unlock`	Desbloquear — file + password
POST	`/api/v1/pdf/watermark`	Marca de agua — file + text

Límites — claros y en la respuesta

Ráfaga: 20 peticiones/minuto, sostenido: 300/hora por clave.
Cuota mensual por cuenta según plan (Pro: 1.000 llamadas/mes). Cada respuesta incluye X-Monthly-Used y X-Monthly-Limit.
Archivos de hasta 50 MB. Los mismos límites de contenido que el sitio.
Errores honestos: 401 clave inválida, 403 sin plan, 413 archivo grande, 429 límite alcanzado (con Retry-After).

Los datos, como siempre

Se procesan en servidores de la UE solo para tu operación y se descartan con la respuesta. La API no relaja nada de la política de privacidad del sitio.