🔌 API de calculadora gratuita

Sinopsis

La API ejecuta exactamente las mismas matemáticas que el sitio web utiliza. Envíe los valores de campo de una calculadora como parámetros de consulta o JSON y obtenga los resultados calculados de nuevo como JSON — incluyendo cualquier esquema de amortización o datos gráficos que la calculadora produce.

• 198+ calculadoras, cada una con su propio punto final
• No hay clave API — acceso anónimo, tasa limitada por IP
• CORS — Access-Control-Allow-Origin: * (uso del cliente)
• Límite de la tasa: 60 solicitudes/hora por IP (HTTP 429 cuando se supere)

URL de la base

https://calculator.free/api/v1/

Índice — lista cada calculadora

GET https://calculator.free/api/v1/

Devuelve una lista legible por máquina de todas las calculadoras con los campos de cada una (llave, etiqueta, tipo, predeterminado, unidad) y las teclas de resultado — lo suficiente para construir un cliente dinámicamente.

Computar — ejecutar una calculadora

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

Forma de respuesta:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Calculadoras de país-aware (hipoteca, préstamo, impuestos sobre la renta, ventas-impuestos...) aceptan ?country=us|uk|ca|au|in|ie|nz|za. Desconocido slug devuelve 404; país no soportado o mala entrada devuelve 400 con un mensaje útil y la especificación de campo.

Planes de autenticación de &

Puede llamar a la API sin ninguna clave — las solicitudes anónimas están limitadas por IP. Para una cuota mensual más alta y predecible (y uso comercial), cree una clave en su página de cuenta y envíela de tres maneras:

GET  https://calculator.free/api/v1/mortgage/?price=350000&key=YOUR_KEY
curl -H "Authorization: Bearer YOUR_KEY" "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"
curl -H "X-Api-Key: YOUR_KEY"           "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"

• Libre — anónima (tipo IP limitado) o una llave libre con una pequeña cuota mensual. No comercial.
• Desarrollador — $9/mo — 10.000 llamadas/mes, uso comercial.
• Negocios — $49/mo — 100.000 llamadas/mes, rendimiento prioritario.

Cuando se utiliza la cuota mensual de una clave, la API devuelve HTTP 429 con el error "quota_exceeded"; una clave desconocida o inactiva devuelve HTTP 401. Ver planes completos y registrarse en el Precios página.

Ejemplos

curl

curl "https://calculator.free/api/v1/mortgage/?price=350000&down=70000&rate=6.9&years=30"

JavaScript fetch()

const r = await fetch(
  "https://calculator.free/api/v1/bmi/?" + new URLSearchParams({
    units: "metric", height: "180", weight: "80"
  }));
const { results } = await r.json();
console.log(results.bmi, results.category);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Todos los puntos finales

Un punto final por calculadora. Las teclas de campo y las teclas de resultado para cada uno están en el /api/v1/ índice.