{"version":1,"name":"Valuation Estimate","slug":"valuation-estimate","method":"POST","path":"/api/valuation/estimate","url":"https://www.agentcompare.ie/api/valuation/estimate","summary":"Estimate a property value from address or coordinate input.","description":"Builds a valuation estimate using nearby PPR sales after geocoding an address, Google place ID, or supplied coordinates.","requestContentType":"application/json","queryParameters":[],"bodyParameters":[{"name":"address","location":"body","type":"string","required":false,"description":"Address to geocode before running the valuation.","example":"12 Seaview Park, Blackrock, Co Dublin"},{"name":"placeId","location":"body","type":"string","required":false,"description":"Google Place ID to geocode before running the valuation.","example":"ChIJx5e-ExamplePlaceId"},{"name":"locationLat","location":"body","type":"number","required":false,"description":"Latitude when coordinates are already known.","example":53.3015},{"name":"locationLng","location":"body","type":"number","required":false,"description":"Longitude when coordinates are already known.","example":-6.1778},{"name":"formattedAddress","location":"body","type":"string","required":false,"description":"Optional display address when coordinates are supplied directly.","example":"12 Seaview Park, Blackrock, Co Dublin"},{"name":"propertyType","location":"body","type":"string","required":false,"description":"Optional property type hint.","example":"semi-detached","enum":["detached","semi-detached","terraced","bungalow","apartment","site"]}],"rateLimit":"Default server settings allow roughly 12 requests per 10 minutes per IP.","notes":["At least one of address, placeId, or a locationLat/locationLng pair is required.","Returns HTTP 503 when Google-backed lookups are disabled in the runtime environment."],"responses":[{"status":200,"description":"Valuation estimate with comparable sales summary.","contentType":"application/json","example":{"address":"12 Seaview Park, Blackrock, Co Dublin","location":{"lat":53.3015,"lng":-6.1778},"estimate":{"low":640000,"mid":685000,"high":730000},"confidence":"medium","comps":[{"id":"sale_123","address":"4 Example Avenue, Blackrock, Co Dublin","sale_price":690000,"sale_date":"2026-01-18"}],"stats":{"compsCount":1,"radiusKm":1.5,"monthsLookback":24}}},{"status":400,"description":"Missing address input or invalid request body.","contentType":"application/json","example":{"error":"Address, placeId, or coordinates are required."}},{"status":429,"description":"Rate limit exceeded.","contentType":"application/json","example":{"error":"Too many valuation checks. Please wait and try again."}}],"documentation":"https://www.agentcompare.ie/docs/api#valuation-estimate","catalog":"https://www.agentcompare.ie/.well-known/api-catalog"}