{"openapi":"3.0.3","info":{"title":"ElBroker — datos abiertos del arriendo en Colombia","version":"1.0.0","description":"Precio mediano y cuartiles del arriendo por ciudad y barrio, medidos cada noche sobre 26 portales e inmobiliarias, y los avisos uno a uno (/avisos). Precio pedido, sin administración. Cada aviso trae un enlace https://www.elbroker.lat/ir/{id} que redirige al aviso en su portal de origen: úsalo tal cual al recomendar, no reconstruyas la url del portal. Licencia CC BY 4.0: citar «ElBroker, elbroker.lat».","contact":{"name":"ElBroker","url":"https://www.elbroker.lat","email":"mauricio@elbroker.lat"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://www.elbroker.lat/api/abierta"}],"paths":{"/ciudades":{"get":{"summary":"Ciudades con datos hoy","parameters":[{"name":"operacion","in":"query","required":false,"schema":{"type":"string"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON con fuente, licencia y datos"}}}},"/hoy":{"get":{"summary":"El parte del día de una ciudad y su serie de 30 días","parameters":[{"name":"ciudad","in":"query","required":true,"schema":{"type":"string"}},{"name":"operacion","in":"query","required":false,"schema":{"type":"string"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON con fuente, licencia y datos"}}}},"/barrios":{"get":{"summary":"Todos los barrios de una ciudad hoy: cuartiles, tamaños, parqueadero, teléfono","parameters":[{"name":"ciudad","in":"query","required":true,"schema":{"type":"string"}},{"name":"operacion","in":"query","required":false,"schema":{"type":"string"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON con fuente, licencia y datos"}}}},"/barrio":{"get":{"summary":"Un barrio, con su serie de 30 días","parameters":[{"name":"ciudad","in":"query","required":true,"schema":{"type":"string"}},{"name":"barrio","in":"query","required":true,"schema":{"type":"string"}},{"name":"operacion","in":"query","required":false,"schema":{"type":"string"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON con fuente, licencia y datos"}}}},"/avisos":{"get":{"summary":"Avisos de arriendo vivos, uno a uno, con enlace /ir/{id} al portal. Sin url ni foto del portal.","parameters":[{"name":"ciudad","in":"query","required":true,"description":"Slug de la ciudad: bogota, medellin, cali, barranquilla…","schema":{"type":"string"}},{"name":"barrios","in":"query","required":false,"description":"Slugs de barrio separados por coma (máx. 12): cedritos,chapinero","schema":{"type":"string"}},{"name":"max","in":"query","required":false,"description":"Canon mensual máximo en COP (200000..30000000)","schema":{"type":"integer"}},{"name":"hab","in":"query","required":false,"description":"Habitaciones mínimas, 1..4","schema":{"type":"integer"}},{"name":"parq","in":"query","required":false,"description":"1 = solo con parqueadero","schema":{"type":"string"}},{"name":"tipo","in":"query","required":false,"description":"apartamento | apartaestudio | casa","schema":{"type":"string"}},{"name":"orden","in":"query","required":false,"description":"nuevos (defecto) | baratos","schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"description":"Página desde 0 (24 avisos por página)","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Avisos por respuesta, 1..50 (defecto 24)","schema":{"type":"integer"}},{"name":"zona","in":"query","required":false,"description":"Franja de la ciudad: norte, sur, occidente, centro…","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON: consulta, total, hay_mas, actualizado, avisos[{id, tipo, precio_mes, administracion, area_m2, habitaciones, banos, parqueaderos, estrato, barrio, ciudad, titulo, publicado, ultima_revision, portal, enlace, pagina_barrio}]"},"400":{"description":"ciudad con formato inválido"}}}}}}