Quick start

La API de Parsear expone dos endpoints principales para automatizar el ciclo completo del contrato de alquiler argentino:

Autenticación

Todas las requests a /api/v1/* requieren el header x-api-key con tu API key. Podés obtener una gratis en /register.

x-api-key: sk_live_your_key_here

Base URL

https://parsear.dev/api/v1

POST /extract

Extrae los datos estructurados de un contrato de alquiler en PDF. El PDF debe ser nativo (con texto seleccionable), no escaneado. Tamaño máximo: 500 KB.

Headers

Body (JSON)

Ejemplo de request

curl -X POST https://parsear.dev/api/v1/extract \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"pdf": "base64encodedpdf..."}'

Response schema

En caso de éxito, la API devuelve HTTP 200 con el siguiente objeto. Los campos no encontrados en el contrato se devuelven como null.

Ejemplo de respuesta

{
  "data": {
    "locador":    { "nombre": "Juan Pérez", "dni": "30123456" },
    "locatario":  { "nombre": "María Gómez", "dni": "35987654" },
    "inmueble":   { "direccion": "Lavalle 567 3° B, CABA", "tipo": "vivienda familiar" },
    "fecha_inicio":      "2026-04-01",
    "duracion_meses":    24,
    "fecha_vencimiento": "2028-03-31",
    "alquiler_inicial":  350000,
    "deposito":          350000,
    "ajuste":     { "indice": "IPC", "frecuencia": "trimestral" },
    "dia_pago":          "1 al 10 de cada mes",
    "garante":           null,
    "rescision":         null,
    "clausulas_especiales": [
      "Prohibido subarrendar",
      "Servicios a cargo del locatario"
    ]
  },
  "request_id": "a1b2c3d4-e5f6-..."
}

Errores

Todos los errores incluyen el campo request_id para facilitar el soporte.

Ejemplos de código

curl -X POST https://parsear.dev/api/v1/extract \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"pdf": "base64encodedpdf..."}'

Límites

POST /generate

Genera un contrato de locación en formato .docx a partir de datos estructurados. Devuelve el archivo Word listo para firmar.

Headers

Body (JSON)

Valores válidos para garantia

Response

En caso de éxito, la API devuelve HTTP 200 con el archivo .docx como respuesta binaria. El header X-Request-Id contiene el ID de correlación para soporte. Los contratos del plan Free incluyen una marca en el pie de página.

Errores

Todos los errores incluyen el campo request_id. Los errores de autenticación y rate limiting son comunes a ambos endpoints.

Ejemplos de código

curl -X POST https://parsear.dev/api/v1/generate \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -o contrato-locacion.docx \
  -d '{
    "locador_nombre":     "Juan Carlos Pérez",
    "locador_dni":        "30123456",
    "locador_domicilio":  "Av. Corrientes 1234, CABA",
    "locador_email":      "jcperez@email.com",
    "locatario_nombre":   "María Elena Gómez",
    "locatario_dni":      "35987654",
    "locatario_email":    "megomez@email.com",
    "inmueble_direccion": "Lavalle 567 3° B, CABA",
    "fecha_inicio":       "2026-04-01",
    "duracion_meses":     24,
    "alquiler_inicial":   350000,
    "ajuste_descripcion": "ICL trimestral",
    "deposito":           350000,
    "primer_mes_monto":   350000,
    "primer_mes_fecha":   "2026-04-01",
    "banco_nombre":       "Banco Nación",
    "banco_cuenta":       "1234567890",
    "banco_cuit":         "20-30123456-9",
    "banco_cbu":          "01234567890123456789012",
    "garantia":           "fianza personal",
    "lugar_firma":        "Ciudad Autónoma de Buenos Aires",
    "fecha_firma":        "2026-03-25"
  }'