API para calcular aumentos de alquiler por ICL, IPC o UVA

Pasale el monto inicial, la fecha de inicio, el índice y cada cuántos meses se ajusta, y la API te devuelve el alquiler vigente, el cronograma completo de períodos con la variación de cada uno y la fecha del próximo aumento.

Cuesta 3 créditos por consulta (entre USD 0,06 y USD 0,09, según el pack). La key de prueba es gratis, sin registro ni tarjeta, y trae 50 créditos. La misma key sirve en las tres APIs de la suite (AR Tools, Índices AR y Direcciones AR), con un solo saldo.

Para qué la usan

Empezá en un minuto

1. Pedí una key de prueba

curl -X POST https://indices-ar-api-103907796853.us-east1.run.app/v1/keys -H 'content-type: application/json' -d '{"name": "mi-sistema"}'

Devuelve key (empieza con ak_, guardala: no se vuelve a mostrar), key_id y los créditos.

2. Llamá a actualizar_alquiler

curl -X POST https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/actualizar_alquiler \
  -H 'Authorization: Bearer ak_...' \
  -H 'content-type: application/json' \
  -d '{"monto_inicial":500000,"fecha_inicio":"2025-01-01","indice":"icl","periodicidad_meses":3}'

Respuesta (abreviada)

{
  "result": {
    "indice": "icl",
    "periodicidad_meses": 3,
    "fecha_inicio": "2025-01-01",
    "monto_inicial": 500000,
    "monto_vigente": 848189.42,
    "variacion_total_pct": 69.64,
    "proximo_ajuste": "2027-01-01",
    "periodos": [
      {
        "desde": "2025-01-01",
        "hasta": "2025-03-31",
        "monto": 500000,
        "factor": null,
        "variacion_pct": null
      },
      {
        "desde": "2025-04-01",
        "hasta": "2025-06-30",
        "monto": 543639.74,
        "factor": 1.087279,
        "variacion_pct": 8.73
      }
    ]
  },
  "credits": {
    "cost": 3,
    "balance": 47
  }
}

Python

import requests

r = requests.post(
    "https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/actualizar_alquiler",
    headers={"Authorization": "Bearer ak_..."},
    json={ "monto_inicial": 500000, "fecha_inicio": "2025-01-01", "indice": "icl", "periodicidad_meses": 3 },
    timeout=30,
)
print(r.json()["result"])

JavaScript

const r = await fetch("https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/actualizar_alquiler", {
  method: "POST",
  headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
  body: JSON.stringify({"monto_inicial":500000,"fecha_inicio":"2025-01-01","indice":"icl","periodicidad_meses":3}),
});
const { result, credits } = await r.json();

Agentes de IA (MCP)

La misma tool está en el servidor MCP https://indices-ar-api-103907796853.us-east1.run.app/mcp, junto con las demás de Índices AR.

claude mcp add --transport http indices-ar https://indices-ar-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
{
  "mcpServers": {
    "indices-ar": {
      "url": "https://indices-ar-api-103907796853.us-east1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer ak_..."
      }
    }
  }
}

n8n

Usá un nodo HTTP Request: método POST, URL https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/actualizar_alquiler, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"monto_inicial":500000,"fecha_inicio":"2025-01-01","indice":"icl","periodicidad_meses":3}. El resultado queda en {{$json.result}}. También podés usar el nodo MCP Client con la URL https://indices-ar-api-103907796853.us-east1.run.app/mcp.

Google Sheets

En Extensiones → Apps Script, pegá esta función. Guardá la key en Configuración del proyecto → Propiedades de la secuencia de comandos con el nombre AR_API_KEY, así no queda en el código. Después usala en una celda: =ALQUILER_ICL(500000; "2025-01-01"; 3). Cada celda hace una consulta y gasta créditos.

function ALQUILER_ICL(monto_inicial, fecha_inicio, periodicidad_meses) {
  const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
  const r = UrlFetchApp.fetch("https://indices-ar-api-103907796853.us-east1.run.app/v1/tools/actualizar_alquiler", {
    method: "post",
    contentType: "application/json",
    headers: { Authorization: "Bearer " + key },
    payload: JSON.stringify({ monto_inicial: monto_inicial, fecha_inicio: fecha_inicio, periodicidad_meses: periodicidad_meses, indice: "icl" }),
  });
  return JSON.parse(r.getContentText()).result.monto_vigente;
}

Preguntas frecuentes

¿Qué índices acepta?

ICL (BCRA), IPC (INDEC), CER y UVA. El ICL fue el de la ley 27.551 y muchos contratos lo siguen usando.

¿Se puede ajustar cada 3, 4, 6 o 12 meses?

Sí, con periodicidad_meses. Cada período se ajusta por la variación del índice entre el inicio del período anterior y el del nuevo.

¿Hay una versión para probar sin programar?

Sí, la calculadora de alquileres gratuita usa el mismo cálculo.

¿Qué pasa cuando se terminan los créditos?

La API responde 402 con un checkout_url para recargar. Los packs se pagan una sola vez, sin suscripción, y los créditos no vencen. Ver precios.

Más

Otras APIs de datos argentinos

Privacidad