{"version":1,"name":"PPR Search","slug":"ppr-search","method":"GET","path":"/api/ppr/search","url":"https://www.agentcompare.ie/api/ppr/search","summary":"Search Irish property sale records stored in the local PPR dataset.","description":"Returns recent sale records that match a free-text address query, with optional county and year filters.","requestContentType":null,"queryParameters":[{"name":"q","location":"query","type":"string","required":true,"description":"Free-text address query. Minimum 2 characters.","example":"Blackrock"},{"name":"county","location":"query","type":"string","required":false,"description":"County filter. Only Dublin is available right now.","example":"Dublin"},{"name":"year","location":"query","type":"number","required":false,"description":"Sale year filter. Supported values are 2025 and 2026.","example":2026},{"name":"limit","location":"query","type":"number","required":false,"description":"Page size. Defaults to 25 and is capped server-side.","example":10},{"name":"offset","location":"query","type":"number","required":false,"description":"Pagination offset. Defaults to 0.","example":0}],"bodyParameters":[],"rateLimit":null,"notes":["Responses are returned as JSON with no-store caching headers.","Records flagged as not full market price are excluded unless the server implementation changes."],"responses":[{"status":200,"description":"Matching sale records.","contentType":"application/json","example":{"results":[{"id":"sale_123","address":"12 Seaview Park, Blackrock, Co Dublin","county":"Dublin","sale_date":"2026-02-14","sale_date_display":"14/02/2026","sale_price":685000,"sale_price_label":"VAT-inclusive","property_type":"Existing / Second-Hand Dwelling house /Apartment","vat_exclusive":false,"not_full_market_price":false,"sale_price_vat_inclusive":null}],"total":1,"page":1,"pageSize":10,"hasMore":false,"meta":{"query":"Blackrock","county":"Dublin","year":2026,"timestamp":"2026-04-19T09:00:00.000Z"}}},{"status":400,"description":"Validation error for query, county, or year filters.","contentType":"application/json","example":{"error":"Query must be at least 2 characters."}}],"documentation":"https://www.agentcompare.ie/docs/api#ppr-search","catalog":"https://www.agentcompare.ie/.well-known/api-catalog"}