{"openapi":"3.1.0","info":{"title":"Precise Rent Public API","version":"1.0.0","description":"Chicago apartment pricing, neighborhoods, and renter guides — live pricing, synced morning and afternoon. Read-only access to Chicago apartment rental data. CC-BY 4.0 — attribute to Precise Rent (https://www.preciserent.com).","contact":{"email":"hello@loopsleasing.com"},"license":{"name":"CC-BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://www.preciserent.com/api/public/v1"}],"paths":{"/buildings":{"get":{"summary":"List active buildings","description":"Filterable, paginated list of all active Chicago apartment buildings with live availability and rent stats.","parameters":[{"name":"neighborhood","in":"query","schema":{"type":"string"},"description":"Neighborhood name (e.g. \"West Loop\", \"Lincoln Park\")"},{"name":"min_rent","in":"query","schema":{"type":"integer"},"description":"Lower bound on cheapest available unit rent"},{"name":"max_rent","in":"query","schema":{"type":"integer"},"description":"Upper bound on cheapest available unit rent"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Building list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildingListResponse"}}}}}}},"/buildings/{id}":{"get":{"summary":"Building detail","description":"Full building record including all available units.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Building ID"}],"responses":{"200":{"description":"Building detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildingDetailResponse"}}}},"404":{"description":"Not found"}}}},"/neighborhoods":{"get":{"summary":"Neighborhood stats","description":"Aggregate rental stats per neighborhood — median rent by bedroom, building count, available unit count. Useful for answering questions like 'what's the median 1BR rent in Wicker Park'.","responses":{"200":{"description":"Neighborhood stats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NeighborhoodListResponse"}}}}}}},"/units":{"get":{"summary":"Search available units","description":"Unit-level search across the entire inventory. Filter by neighborhood, bedrooms, rent range.","parameters":[{"name":"neighborhood","in":"query","schema":{"type":"string"}},{"name":"bedrooms","in":"query","schema":{"type":"number"},"description":"0 = studio, 0.5 = Jr 1BR, 1, 2, 3..."},{"name":"min_rent","in":"query","schema":{"type":"integer"}},{"name":"max_rent","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Unit list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnitListResponse"}}}}}}}},"components":{"schemas":{"Coordinates":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"ResponseMeta":{"type":"object","properties":{"license":{"type":"string","example":"CC-BY 4.0"},"attribution":{"type":"string","example":"Precise Rent (https://www.preciserent.com)"}}},"Building":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"neighborhood":{"type":["string","null"]},"address":{"type":["string","null"]},"zipCode":{"type":["string","null"]},"coordinates":{"oneOf":[{"$ref":"#/components/schemas/Coordinates"},{"type":"null"}]},"yearBuilt":{"type":["integer","null"]},"totalUnits":{"type":["integer","null"]},"availableUnits":{"type":"integer"},"rent":{"type":"object","properties":{"min":{"type":["number","null"]},"median":{"type":["number","null"]}}},"url":{"type":"string"},"markdownUrl":{"type":"string"}}},"BuildingListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Building"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}},"BuildingDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Building"},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}},"Neighborhood":{"type":"object","properties":{"neighborhood":{"type":"string"},"slug":{"type":"string"},"buildings":{"type":"integer"},"availableUnits":{"type":"integer"},"minRent":{"type":["number","null"]},"medianRent":{"type":"object","properties":{"studio":{"type":["number","null"]},"1br":{"type":["number","null"]},"2br":{"type":["number","null"]},"3br":{"type":["number","null"]}}},"url":{"type":"string"},"markdownUrl":{"type":"string"}}},"NeighborhoodListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Neighborhood"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}},"Unit":{"type":"object","properties":{"unitId":{"type":"integer"},"buildingId":{"type":"integer"},"buildingName":{"type":"string"},"neighborhood":{"type":["string","null"]},"address":{"type":["string","null"]},"unitNumber":{"type":["string","null"]},"bedrooms":{"type":"number"},"bathrooms":{"type":["number","null"]},"sqft":{"type":["integer","null"]},"rent":{"type":"number"},"availableOn":{"type":["string","null"],"format":"date"},"url":{"type":"string"},"markdownUrl":{"type":"string"}}},"UnitListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Unit"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}}}}