{"openapi":"3.1.0","info":{"title":"LandLens public API","version":"1.0.0","description":"Read-only access to LandLens: U.S. college-town rental addresses from municipal rental registries, verified tenant reviews, public records (licenses, code violations, eviction filings) with sources, and landlord/owner names. Rate-limited per IP; identify your agent in User-Agent. Writes require a user session — see https://getlandlens.com/.well-known/auth.md.","contact":{"email":"hello@getlandlens.com","url":"https://getlandlens.com"},"license":{"name":"Data: CC BY 4.0 for aggregate pages; API responses for the requesting user only"},"x-access":"Free: 500 requests/day per IP on data endpoints. Data API plan ($49/mo): X-API-Key header, 20,000 requests/day. Sign up at https://getlandlens.com/api"},"servers":[{"url":"https://api.getlandlens.com"}],"paths":{"/api/colleges":{"get":{"operationId":"searchColleges","summary":"Search campuses by name or email domain","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Matches","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/College"}}}}}}}},"/api/colleges/featured":{"get":{"operationId":"featuredColleges","summary":"Campuses with the most listings","responses":{"200":{"description":"OK"}}}},"/api/properties":{"get":{"operationId":"searchProperties","summary":"List rentals near a campus, optionally filtered by address text","parameters":[{"name":"college","in":"query","required":true,"schema":{"type":"string"},"description":"College id, e.g. osu.edu"},{"name":"q","in":"query","schema":{"type":"string"},"description":"Address substring"},{"name":"limit","in":"query","schema":{"type":"integer","maximum":100}}],"responses":{"200":{"description":"Properties","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PropertySummary"}}}}}}}},"/api/properties/{id}":{"get":{"operationId":"getProperty","summary":"Full detail for one address: grade, safety flags, public records with sources, tenant-reported landlords, aggregate tenant stats","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Property","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Property"}}}},"404":{"description":"Unknown id"}}}},"/api/properties/{id}/reviews":{"get":{"operationId":"getReviews","summary":"Verified tenant reviews for an address (no tenant names, no individual rents)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reviews","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Review"}}}}}}}},"/api/landlords":{"get":{"operationId":"getLandlord","summary":"Tenant-reported landlord profile across addresses","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Landlord profile"}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Optional. Raises the quota to your plan. Get one at https://getlandlens.com/api"}},"schemas":{"College":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"state":{"type":"string"}}},"Record":{"type":"object","properties":{"type":{"type":"string","enum":["eviction","violation","permit","license"]},"date":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"}}},"PropertySummary":{"type":"object","properties":{"id":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"collegeId":{"type":"string"},"grade":{"type":["string","null"]},"avgRating":{"type":"number"},"reviewCount":{"type":"integer"},"records":{"type":"array","items":{"$ref":"#/components/schemas/Record"}}}},"Property":{"allOf":[{"$ref":"#/components/schemas/PropertySummary"},{"type":"object","properties":{"safety":{"type":"object"},"landlords":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"propertyCount":{"type":"integer"}}}},"tenantStats":{"type":["object","null"]}}}]},"Review":{"type":"object","properties":{"id":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":5},"tags":{"type":"array","items":{"type":"string"}},"text":{"type":"string"},"tenancy":{"type":"string"},"verified":{"type":"string"},"landlordName":{"type":"string"},"createdAt":{"type":"string"},"recommend":{"type":"boolean"},"repairs":{"type":"string"},"deposit":{"type":"string"}}}}}}