{"components":{"schemas":{"Busqueda":{"properties":{"checkin":{"format":"date","type":"string"},"checkout":{"format":"date","type":"string"},"comunas_disponibles":{"description":"Solo cuando no hay resultados: comunas con deptos publicados.","items":{"type":"string"},"type":"array"},"guests":{"type":"integer"},"noches":{"type":"integer"},"nota":{"type":"string"},"otros_disponibles_sin_cotizar":{"description":"Aproximado: deptos sin reserva en el rango que no se alcanzaron a cotizar.","type":"integer"},"resultados":{"items":{"$ref":"#/components/schemas/Cotizacion"},"type":"array"},"total_resultados":{"type":"integer"}},"type":"object"},"Cotizacion":{"properties":{"checkin":{"format":"date","type":"string"},"checkout":{"format":"date","type":"string"},"departamento":{"$ref":"#/components/schemas/Departamento"},"detalle":{"type":"string"},"disponible":{"type":"boolean"},"guests":{"type":"integer"},"limpieza":{"type":"number"},"minimo_noches":{"type":["integer","null"]},"moneda":{"description":"Moneda de los montos. Hoy es USD; leerla siempre en vez de suponerla.","example":"USD","type":"string"},"motivo":{"enum":["excede_capacidad","fechas_ocupadas","estadia_minima","sin_tarifa"],"type":"string"},"noches":{"type":"integer"},"nota_pago":{"type":"string"},"precio_por_noche":{"items":{"properties":{"fecha":{"format":"date","type":"string"},"precio":{"type":"number"}},"type":"object"},"type":"array"},"precio_por_noche_promedio":{"type":"number"},"subtotal_noches":{"type":"number"},"total":{"description":"Lo mismo que se cobra en el checkout de mrbnb.cl.","type":"number"},"total_clp_estimado":{"type":["integer","null"]},"url_reserva":{"format":"uri","type":"string"}},"type":"object"},"Departamento":{"properties":{"banos":{"type":["number","null"]},"capacidad_maxima":{"type":["integer","null"]},"comuna":{"type":["string","null"]},"dormitorios":{"type":["integer","null"]},"foto":{"format":"uri","type":["string","null"]},"id":{"type":"integer"},"tipologia":{"type":["string","null"]},"titulo":{"type":"string"},"url_ficha":{"format":"uri","type":"string"},"zona_aproximada":{"description":"Centro desplazado a prop\u00f3sito: el depto queda dentro del radio, la direcci\u00f3n no se publica.","properties":{"lat":{"type":"number"},"lng":{"type":"number"},"nota":{"type":"string"},"radio_m":{"type":"integer"}},"type":["object","null"]}},"type":"object"},"Error":{"properties":{"error":{"properties":{"campo":{"type":"string"},"codigo":{"type":"string"},"mensaje":{"type":"string"}},"type":"object"}},"type":"object"}}},"info":{"contact":{"email":"contacto@mrbnb.cl","name":"Mr BnB","url":"https://mrbnb.cl/es/agentes"},"description":"API p\u00fablica de solo lectura para agentes de IA y desarrolladores. Busca departamentos disponibles, entrega el precio total y el link para reservar. No crea reservas ni cobra: el hu\u00e9sped abre `url_reserva` y paga en mrbnb.cl, en pesos chilenos al tipo de cambio del d\u00eda. La moneda de cada tarifa viene en `moneda` (hoy es USD).\n\nRead-only public API for AI agents. Search available apartments in Santiago, Chile, get the total price and a prefilled booking link. Nothing here books or charges: the guest opens `url_reserva` and pays at mrbnb.cl.","summary":"Departamentos amoblados por noche en Santiago de Chile.","title":"Mr BnB: disponibilidad y cotizaci\u00f3n","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/public/quote/{id}":{"get":{"operationId":"cotizar","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}},{"description":"Fecha de llegada (AAAA-MM-DD). Desde hoy y hasta 18 meses adelante.","in":"query","name":"checkin","required":true,"schema":{"example":"2026-12-10","format":"date","type":"string"}},{"description":"Fecha de salida (AAAA-MM-DD). M\u00e1ximo 90 noches.","in":"query","name":"checkout","required":true,"schema":{"example":"2026-12-10","format":"date","type":"string"}},{"description":"N\u00famero de hu\u00e9spedes.","in":"query","name":"guests","required":false,"schema":{"default":1,"maximum":16,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cotizacion"}}},"description":"Cotizaci\u00f3n. Si `disponible` es false, `motivo` dice por qu\u00e9."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Par\u00e1metro inv\u00e1lido."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No hay un departamento publicado con ese id."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Demasiadas solicitudes."}},"summary":"Cotizar un departamento / Quote one apartment"}},"/api/public/search":{"get":{"operationId":"buscarDisponibilidad","parameters":[{"description":"Fecha de llegada (AAAA-MM-DD). Desde hoy y hasta 18 meses adelante.","in":"query","name":"checkin","required":true,"schema":{"example":"2026-12-10","format":"date","type":"string"}},{"description":"Fecha de salida (AAAA-MM-DD). M\u00e1ximo 90 noches.","in":"query","name":"checkout","required":true,"schema":{"example":"2026-12-10","format":"date","type":"string"}},{"description":"N\u00famero de hu\u00e9spedes.","in":"query","name":"guests","required":false,"schema":{"default":1,"maximum":16,"minimum":1,"type":"integer"}},{"description":"Comuna de Santiago (Providencia, Las Condes, Santiago...). Sin tildes tambi\u00e9n sirve.","in":"query","name":"comuna","required":false,"schema":{"example":"Providencia","maxLength":60,"type":"string"}},{"description":"M\u00ednimo de dormitorios (0 = estudio).","in":"query","name":"dormitorios","required":false,"schema":{"maximum":10,"minimum":0,"type":"integer"}},{"in":"query","name":"limite","required":false,"schema":{"default":10,"maximum":20,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Busqueda"}}},"description":"Resultados ordenados por precio total."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Par\u00e1metro inv\u00e1lido."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Demasiadas solicitudes, o el buscador est\u00e1 ocupado (ver Retry-After)."}},"summary":"Buscar departamentos disponibles / Search available apartments"}}},"servers":[{"url":"https://mrbnb.cl"}]}
