{"name":"flatin.pt API","version":"v1","description":"Keyless public API for Portuguese home-buying data: new-build developments, municipality figures, where-to-live guides, the construction barometer, IMI rates and the taxes of a purchase.","endpoints":[{"method":"GET","path":"/api/v1/barometer/official.csv","summary":"The official INE series the barometer is checked against"},{"method":"GET","path":"/api/v1/barometer/sce.csv","summary":"ADENE energy-certificate statistics (SCE) for new housing"},{"method":"GET","path":"/api/v1/barometer/series","summary":"The same barometer series as JSON, with attribution"},{"method":"GET","path":"/api/v1/barometer/series.csv","summary":"Building-permit barometer: monthly case counts per municipality"},{"method":"GET","path":"/api/v1/construction-barometer","summary":"Construction barometer: building-works cases and INE licences"},{"method":"POST","path":"/api/v1/consultation","summary":"Send a request to flatin.pt, a licensed estate agency (two steps)"},{"method":"GET","path":"/api/v1/facts.json","summary":"Dated facts about Portugal, each with its primary source"},{"method":"GET","path":"/api/v1/funnel","summary":"Housing pipeline by municipality: cases, licences, completions"},{"method":"GET","path":"/api/v1/funnel.csv","summary":"Housing pipeline of the 308 municipalities, as CSV"},{"method":"GET","path":"/api/v1/glossary","summary":"Glossary of Portuguese home-buying terms: the list"},{"method":"GET","path":"/api/v1/glossary/{term}","summary":"One glossary term: definition, law reference and page"},{"method":"GET","path":"/api/v1/imi/rates","summary":"IMI rates for all municipalities"},{"method":"GET","path":"/api/v1/imi/rates-history.csv","summary":"Every verified year of IMI rates in one CSV file"},{"method":"GET","path":"/api/v1/imi/rates.csv","summary":"The same rates as one CSV file"},{"method":"GET","path":"/api/v1/imi/rates.geojson","summary":"IMI rates with municipality boundaries (GeoJSON)"},{"method":"GET","path":"/api/v1/imi/rates/{codigo}","summary":"IMI rate of one municipality"},{"method":"POST","path":"/api/v1/imt/calculate","summary":"What a purchase costs on top of the price"},{"method":"GET","path":"/api/v1/licensing-duration","summary":"Age of licensing cases in progress: Porto and Lisbon"},{"method":"GET","path":"/api/v1/licensing-duration.csv","summary":"Age of licensing cases in progress, as CSV"},{"method":"POST","path":"/api/v1/mortgage/calculate","summary":"Mortgage payment, minimum income and cash at the deed"},{"method":"GET","path":"/api/v1/municipalities/compare","summary":"Compare 2 to 5 municipalities side by side"},{"method":"GET","path":"/api/v1/municipalities/{municipality}/stats","summary":"Everything flatin.pt publishes about one municipality"},{"method":"GET","path":"/api/v1/newbuilds","summary":"Search new-build projects in Portugal"},{"method":"GET","path":"/api/v1/newbuilds/{slug}","summary":"One new-build project: prices, status, purchase cost, nearby"},{"method":"GET","path":"/api/v1/open-data-coverage","summary":"The same open-data index as JSON, with attribution"},{"method":"GET","path":"/api/v1/open-data-coverage.csv","summary":"Open data of the 308 municipalities: what each one publishes"},{"method":"GET","path":"/api/v1/reports/obra-nova.json","summary":"Monthly report 'Obra nova em Portugal': list of editions"},{"method":"GET","path":"/api/v1/reports/obra-nova/{edition}.csv","summary":"One edition of the monthly new-build report as CSV"},{"method":"GET","path":"/api/v1/reports/obra-nova/{edition}.json","summary":"One edition of the monthly new-build report as JSON, with attribution"},{"method":"POST","path":"/api/v1/subscriptions","summary":"Subscribe an email to new developments or construction"},{"method":"GET","path":"/api/v1/where-to-live","summary":"Where-to-live guides: the list of cities and regions"},{"method":"GET","path":"/api/v1/where-to-live.csv","summary":"Where to live in Portugal: the city guides compared, as CSV"},{"method":"GET","path":"/api/v1/where-to-live/{city}","summary":"Where to live in a city: verdict by area, noise and safety"}],"openapi":"https://flatin.pt/api/openapi.json","documentation":"https://flatin.pt/en/tools/api-and-data/","terms":"https://flatin.pt/en/legal/terms/","status":"https://flatin.pt/status/","rate_limits":"https://flatin.pt/api/rate-limits.json","mcp":"https://flatin.pt/mcp"}