Referencia de la API

Método 1: Llamada única (síncrono)

Suba un archivo e inicie la extracción en una sola petición. Por defecto, la llamada devuelve inmediatamente una respuesta 202 con un ID de extracción: sondee el resultado o use un webhook. Pase wait para mantener la petición abierta y recibir documentos pequeños directamente.

Método 2: Subida + Extracción (asíncrono)

Un flujo de tres pasos: suba primero el archivo, luego inicie una extracción y después sondee el resultado. Este método le da más control - puede reutilizar el mismo archivo subido para varias extracciones con esquemas diferentes.

Extraer desde una URL

En lugar de subir el archivo, envíe su dirección como file_url, en la solicitud form-data o en la solicitud JSON. Parse descarga el documento y a partir de ahí lo trata exactamente igual que una subida: el mismo límite de tamaño, el mismo cómputo de páginas y la misma reutilización de resultados guardados. Es útil para herramientas de automatización que solo tienen el archivo como enlace.

Envíe file (o file_id) o file_url, no ambos. El enlace debe ser una dirección http o https pública que se abra sin iniciar sesión; las direcciones privadas e internas se rechazan, también tras una redirección. La descarga debe completarse en 20 segundos y el archivo puede ocupar como máximo 100 MB. Si no se puede obtener el archivo, la solicitud falla con un 400 (413 si es demasiado grande) que explica el motivo, y no se consumen páginas.

Ejemplo

curl -X POST https://api-parse.conversiontools.io/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_url": "https://example.com/files/invoice.pdf", "filename": "invoice.pdf", "schema_id": "sch_456...", "webhook_url": "https://example.com/hooks/parse"}'

Webhooks

Pase una webhook_url y Parse enviará un POST a esa dirección en cuanto la extracción termine o falle, así nunca tendrá que sondear. La notificación contiene solo el ID de la extracción y el estado, nunca los datos extraídos; recupere el resultado a través de la API. La URL debe ser una dirección http o https pública; las direcciones privadas e internas se rechazan. La entrega se reintenta varias veces y nunca afecta a la extracción en sí. Una solicitud respondida con un resultado guardado también recibe su webhook, de inmediato, y una solicitud asociada a una extracción del mismo documento que ya está en curso lo recibe cuando esa extracción termina.

Contenido de la notificación

{
  "event": "extraction.completed",
  "id": "ext_789...",
  "status": "completed",
  "pages_used": 2,
  "error": null,
  "created_at": "2026-07-26T10:00:00.000Z",
  "completed_at": "2026-07-26T10:00:41.000Z"
}

Extracciones repetidas

Si envía de nuevo el mismo documento con el mismo esquema, Parse devuelve inmediatamente el resultado guardado, sin contar contra sus páginas. Esas respuestas incluyen "cached": true. Si edita el esquema o pasa no_cache, se ejecuta una extracción nueva. Si una de estas solicitudes incluye una webhook_url, se sigue llamando.

Exportar a CSV / Excel

Convierta el resultado de una extracción completada en una hoja de cálculo. Las exportaciones son gratuitas, repetibles y no consumen páginas. Los arrays anidados se desnormalizan: los campos de cabecera se repiten en cada fila, así que la salida está lista para tablas dinámicas e importaciones. Consejo: pase output_format (csv o xlsx) en la petición de extracción y la exportación se inicia automáticamente en cuanto la extracción se completa.

Ejemplo

curl -X DELETE https://api-parse.conversiontools.io/v1/extractions/ext_789... \
  -H "Authorization: Bearer YOUR_API_KEY"