API / CLI de Portal Inmuebles

Interfaz programática para publicar, tasar y gestionar propiedades sin usar el navegador. Compatible con Claude Code, Aider, Open Interpreter y cualquier herramienta que pueda hacer HTTP requests.

llms.txt →ai-cli.json →Docs JSON API →

🤖 Para asistentes de IA (Claude Code, etc.)

Si eres una IA leyendo esta página, ve directamente a https://portalinmuebles.cl/llms.txt para una descripción estructurada del API en formato optimizado para LLMs.

También puedes consultar el discovery endpoint: /.well-known/ai-cli.json

Quick Start

Crea tu cuenta en portalinmuebles.cl si aún no la tienes.
Genera tu token CLI desde Dashboard > CLI. Formato: cli_xxxxx
Ejecuta comandos via POST a https://portalinmuebles.cl/api/cli/execute

Ejemplo: publicar una propiedad

curl -X POST https://portalinmuebles.cl/api/cli/execute \
  -H "Authorization: Bearer $CLI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "command": "properties",
    "subcommand": "create",
    "args": {
      "title": "Casa 3D 2B Providencia",
      "listing_type": "sale",
      "property_type": "casa",
      "price": 8500,
      "moneda_publicacion": "UF",
      "address": "Hernando de Aguirre 1234",
      "city": "Providencia",
      "state": "Metropolitana de Santiago",
      "bedrooms": 3,
      "bathrooms": 2,
      "square_meters": 180
    }
  }'

Comandos principales

properties (gestión de propiedades)

properties:list — lista propiedades del usuario
properties:get — detalle de una propiedad
properties:create — crear propiedad nueva
properties:update — actualizar propiedad
properties:delete / :activate / :deactivate
properties:add-image / :add-video
properties:bulk-update / :bulk-create (PRO+)

tasacion (tasación con IA)

tasacion:iniciar — tasar propiedad
tasacion:estado / :historial / :cuota

Otros

uf:current — valor UF del día
credits:balance / :history / :packs
search:properties — buscar en todo el portal
profile:get / :update
analytics:summary / :views (BASIC+)
viral:balance / :commissions (BASIC+)
blog:list / :create / :update (ADMIN only)

Lista completa: GET /api/cli (retorna JSON con todos los comandos por tier).

Campos de propiedad

Requeridos al crear

title — nombre de la publicación

listing_type — sale o rent

property_type — casa, departamento, parcela, oficina, terreno, local

price — número

moneda_publicacion — UF o CLP

address — dirección completa

city — COMUNA (no ciudad capital)

state — REGIÓN chilena

Opcionales comunes

description (HTML permitido)

bedrooms, bathrooms, parking_spots

square_meters, built_surface

images (array con url, isPrimary)

videos (array URLs YouTube/Vimeo, máx 3)

furnished, pet_friendly, canje_enabled

Subir fotos

Las fotos se suben como multipart/form-data a POST /api/properties/upload.

El sistema aplica automáticamente: resize a max 1920x1080, conversión a WebP q85, auto-rotate según EXIF (corrige fotos de celular), genera 3 thumbnails (400x300, 800x600, 150x150), scan antimalware (magic bytes + MIME + script injection).

curl -X POST https://portalinmuebles.cl/api/properties/upload \
  -H "Authorization: Bearer $CLI_TOKEN" \
  -F "file=@foto.jpg" \
  -F "propertyId=<uuid>" \
  -F "applyWatermark=false"

Límites por plan

Plan	Comandos	Rate limit
FREE	Read-only: list, get, search, tasacion, uf, profile, credits	10/min
BASIC	+ create, update, activate, add-image/video	20/min
PRO	+ bulk-update, clone, delete, analytics:export	60/min
ENTERPRISE	+ bulk-delete, webhooks, todos los analytics	120/min

Portalinmuebles.cl