Endpoints
Ungrouped Endpoints 9
What is the Property Comparable Sales API?
Comparable property sales from 16 government registries: UK, France, Ireland, Singapore, Taiwan, Dubai and 10 US cities. 51M+ recorded transactions, one request shape for every market. Actual sales, not estimates or listings.
Property Comparable Sales API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.
Property Comparable Sales API endpoints
- GET
/healthHealth check
Service status, the number of markets online and the date the data was last refreshed.
- GET
/marketsList markets
All 16 markets with currency, transaction count, the name of the location parameter and a working example value. Call this first to discover how to query a market.
- GET
/v1/compsSearch comparable sales
Recorded sales within a radius of a location, with median, average, min, max and count. Returns unit-level sales by default so portfolio transfers do not distort the median.
- GET
/v1/comps/csvCSV export
The same search as the comparable sales endpoint, returned as text/csv for spreadsheet use.
- GET
/v1/resolveResolve an address to a market
Turns free text, a place name or a postcode into a market code, the correct location parameter and a ready-to-call URL.
- GET
/v1/statsArea statistics
Median, average, percentiles and counts by property type. US markets also return gross rental yield from HUD SAFMR FY2026 or Census ACS 5-Year 2023.
- GET
/v1/trendsMonthly price trends
Monthly median and average sale price for an area, with year-over-year change.
- GET
/v1/valuationIndicative valuation
An indicative value derived from recorded comparable sales, returned with the comparables used, the method and a confidence score. Returns 422 rather than guessing when the evidence is too thin.
- GET
/v1/valuation/pdfPDF valuation report
A multi-page PDF with charts, statistics, the method and the comparables table. Available in English, French, Spanish and Traditional Chinese.
Frequently asked questions about Property Comparable Sales API
Where does the data come from?
Official government property registries: HM Land Registry, DVF, the Dubai Land Department, US county assessors and recorders, and their equivalents in Ireland, Singapore and Taiwan. Sixteen sources, refreshed monthly. Nothing is scraped and nothing is modelled.
Is this an estimate, like an automated valuation?
No. Comparable sales, area statistics and trends return only sales that actually happened and were recorded by a public authority. The valuation endpoint does produce an indicative figure, but it is derived from those recorded sales and comes back with the comparables, the method and a confidence score, and returns 422 rather than guessing when there is not enough evidence.
Why did my search return results further away than I asked for?
The relax parameter defaults to true: when the filters match no sales, the search widens, radius first and then the time window. The response carries a header marking a relaxed search. Pass relax=false to switch that off and get an empty result instead.
How fresh is the data?
Registries publish on their own schedules, from monthly to quarterly, and the API is refreshed monthly. Connecticut records end on 30 September 2024. The health endpoint reports the date of the last refresh.