{"openapi":"3.1.0","info":{"title":"Cambio Uruguay — datos abiertos","version":"1.0","description":"Estadísticas diarias de precios pedidos de alquileres, viviendas en venta y autos usados en Uruguay, y búsqueda de avisos. Sin clave, sin registro, CORS abierto. Las estadísticas van con licencia CC BY 4.0; los avisos no se licencian.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/deed.es"},"contact":{"name":"Cambio Uruguay","url":"https://cambio-uruguay.com/contacto"}},"externalDocs":{"url":"https://cambio-uruguay.com/datos-abiertos-uruguay"},"servers":[{"url":"https://cambio-uruguay.com"}],"paths":{"/api/datos/mercado/actual":{"get":{"operationId":"actual","summary":"Precio de hoy, lugar por lugar","description":"La mediana, el p25, el p75 y la variación de la misma oferta del último día, para todos los departamentos y barrios (o todos los modelos de auto) con muestra suficiente. Es la tabla para comparar: cuánto se pide por un apartamento de 2 dormitorios en cada barrio.\n\nLicencia CC BY 4.0: citá «Fuente: Cambio Uruguay (cambio-uruguay.com)» con un enlace.","parameters":[{"name":"mercado","in":"query","required":true,"description":"Qué mercado","schema":{"type":"string","enum":["alquiler","venta","autos"]}},{"name":"moneda","in":"query","required":false,"description":"Moneda de los avisos (nunca se convierte). Por defecto UYU en alquiler, USD en venta","schema":{"type":"string","enum":["UYU","USD"]}},{"name":"tipo","in":"query","required":false,"description":"Tipo de vivienda","schema":{"type":"string","enum":["todas","apartamento","casa"]}},{"name":"dormitorios","in":"query","required":false,"description":"Dormitorios","schema":{"type":"string","enum":["todos","0","1","2","3","4plus"]}},{"name":"departamento","in":"query","required":false,"description":"Slug del departamento","schema":{"type":"string","example":"montevideo"}}],"responses":{"200":{"description":"Sobre con la fuente, la licencia y los datos en `datos`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Parámetro inválido; el motivo viene en `statusMessage`."}}}},"/api/datos/mercado/serie":{"get":{"operationId":"serie","summary":"La serie diaria de una cohorte","description":"Un punto por día desde el arranque de la medición: nivel (p25, mediana, p75, mediana por m²) y variación de la misma oferta a 7, 30 y 90 días. Se pide con parámetros legibles o con la clave que devuelven las otras rutas.\n\nLicencia CC BY 4.0: citá «Fuente: Cambio Uruguay (cambio-uruguay.com)» con un enlace.","parameters":[{"name":"mercado","in":"query","required":false,"description":"Qué mercado","schema":{"type":"string","enum":["alquiler","venta","autos"]}},{"name":"moneda","in":"query","required":false,"description":"Moneda de los avisos (nunca se convierte). Por defecto UYU en alquiler, USD en venta","schema":{"type":"string","enum":["UYU","USD"]}},{"name":"tipo","in":"query","required":false,"description":"Tipo de vivienda","schema":{"type":"string","enum":["todas","apartamento","casa"]}},{"name":"dormitorios","in":"query","required":false,"description":"Dormitorios","schema":{"type":"string","enum":["todos","0","1","2","3","4plus"]}},{"name":"departamento","in":"query","required":false,"description":"Slug del departamento","schema":{"type":"string","example":"montevideo"}},{"name":"barrio","in":"query","required":false,"description":"Slug del barrio (con departamento)","schema":{"type":"string","example":"pocitos"}},{"name":"modelo","in":"query","required":false,"description":"Autos: slug marca-modelo","schema":{"type":"string","example":"toyota-hilux"}},{"name":"anio","in":"query","required":false,"description":"Autos: año del modelo","schema":{"type":"string","example":"2018"}},{"name":"clave","in":"query","required":false,"description":"Alternativa: la clave tal cual la devuelve /actual","schema":{"type":"string","example":"alquiler|UYU|apartamento|2|d:montevideo"}}],"responses":{"200":{"description":"Sobre con la fuente, la licencia y los datos en `datos`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Parámetro inválido; el motivo viene en `statusMessage`."}}}},"/api/datos/mercado":{"get":{"operationId":"mercado","summary":"Qué hay medido","description":"Los lugares (o modelos de auto) que tienen serie hoy, con cuántos avisos hay detrás, desde qué día se mide y los mayores movimientos de la misma oferta.\n\nLicencia CC BY 4.0: citá «Fuente: Cambio Uruguay (cambio-uruguay.com)» con un enlace.","parameters":[{"name":"mercado","in":"query","required":true,"description":"Qué mercado","schema":{"type":"string","enum":["alquiler","venta","autos"]}}],"responses":{"200":{"description":"Sobre con la fuente, la licencia y los datos en `datos`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Parámetro inválido; el motivo viene en `statusMessage`."}}}},"/api/datos/alquileres":{"get":{"operationId":"alquileres","summary":"Buscar alquileres","description":"Avisos vigentes del directorio de alquileres (Mercado Libre, InfoCasas, Casasweb, El País, Facebook y más, unificados), con el enlace a su ficha. Hasta 24 por página.\n\nLos avisos son de sus anunciantes y de los portales donde se publicaron: no se licencian. Usalos para buscar y enlazar a la ficha (campo url), no para republicar el directorio.","parameters":[{"name":"departamento","in":"query","required":false,"description":"Departamento","schema":{"type":"string","example":"Montevideo"}},{"name":"barrio","in":"query","required":false,"description":"Barrio","schema":{"type":"string","example":"Cordón"}},{"name":"tipo","in":"query","required":false,"description":"apartamento, casa, …","schema":{"type":"string","example":"apartamento"}},{"name":"dormitorios","in":"query","required":false,"description":"Mínimo de dormitorios","schema":{"type":"string","example":"2"}},{"name":"moneda","in":"query","required":false,"description":"UYU o USD","schema":{"type":"string"}},{"name":"precioMin","in":"query","required":false,"description":"Precio mínimo","schema":{"type":"string"}},{"name":"precioMax","in":"query","required":false,"description":"Precio máximo","schema":{"type":"string","example":"30000"}},{"name":"mascotas","in":"query","required":false,"description":"1 = acepta mascotas","schema":{"type":"string"}},{"name":"amueblado","in":"query","required":false,"description":"1 = amueblado","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Texto libre","schema":{"type":"string"}},{"name":"orden","in":"query","required":false,"description":"recientes, precio, precio-desc, metros, baja","schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"description":"Página (1–50)","schema":{"type":"string"}},{"name":"porPagina","in":"query","required":false,"description":"Avisos por página (máx. 24)","schema":{"type":"string"}}],"responses":{"200":{"description":"Sobre con la fuente, la licencia y los datos en `datos`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Parámetro inválido; el motivo viene en `statusMessage`."}}}},"/api/datos/autos":{"get":{"operationId":"autos","summary":"Buscar autos usados","description":"Avisos vigentes del directorio de autos usados (diez fuentes, un auto una sola vez), en dólares, con el enlace a su ficha y a la página de precios del modelo. Hasta 24 por página.\n\nLos avisos son de sus anunciantes y de los portales donde se publicaron: no se licencian. Usalos para buscar y enlazar a la ficha (campo url), no para republicar el directorio.","parameters":[{"name":"marca","in":"query","required":false,"description":"Slug de la marca","schema":{"type":"string","example":"toyota"}},{"name":"modelo","in":"query","required":false,"description":"Slug marca-modelo","schema":{"type":"string","example":"toyota-corolla"}},{"name":"anioMin","in":"query","required":false,"description":"Año mínimo","schema":{"type":"string"}},{"name":"anioMax","in":"query","required":false,"description":"Año máximo","schema":{"type":"string"}},{"name":"kmMax","in":"query","required":false,"description":"Kilómetros máximos","schema":{"type":"string"}},{"name":"precioMinUsd","in":"query","required":false,"description":"Precio mínimo en US$","schema":{"type":"string"}},{"name":"precioMaxUsd","in":"query","required":false,"description":"Precio máximo en US$","schema":{"type":"string","example":"15000"}},{"name":"combustible","in":"query","required":false,"description":"nafta, diesel, hibrido, electrico","schema":{"type":"string"}},{"name":"caja","in":"query","required":false,"description":"manual o automatica","schema":{"type":"string"}},{"name":"departamento","in":"query","required":false,"description":"Departamento","schema":{"type":"string"}},{"name":"vendedor","in":"query","required":false,"description":"dealer o private","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Texto libre","schema":{"type":"string"}},{"name":"orden","in":"query","required":false,"description":"price_asc, price_desc, km_asc, year_desc","schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"description":"Página (1–50)","schema":{"type":"string"}},{"name":"porPagina","in":"query","required":false,"description":"Avisos por página (máx. 24)","schema":{"type":"string"}}],"responses":{"200":{"description":"Sobre con la fuente, la licencia y los datos en `datos`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Parámetro inválido; el motivo viene en `statusMessage`."}}}}},"components":{"schemas":{"Envelope":{"type":"object","required":["version","fuente","datos"],"properties":{"version":{"type":"string"},"fuente":{"type":"object","properties":{"nombre":{"type":"string"},"url":{"type":"string"},"pagina":{"type":"string"},"atribucion":{"type":"string"},"licencia":{"type":["object","null"]},"nota":{"type":"string"}}},"actualizado":{"type":["string","null"]},"datos":{}}}}}}