API, MCP et données ouvertes
Les mêmes chiffres que sur le site, lisibles par une machine : IMT et droit de timbre à l'achat, taux d'IMI des 308 communes. Sans clé et sans inscription.
Mis à jour le
API HTTP
JSON sur HTTPS, sans authentification. Le schéma OpenAPI est en fin de liste : c'est lui que lisent les outils.
GET |
/api/v1/barometer/official.csv |
The official INE series the barometer is checked against |
GET |
/api/v1/barometer/sce.csv |
ADENE energy-certificate statistics (SCE) for new housing |
GET |
/api/v1/barometer/series |
The same barometer series as JSON, with attribution |
GET |
/api/v1/barometer/series.csv |
Building-permit barometer: monthly case counts per municipality |
GET |
/api/v1/imi/rates |
IMI rates for all municipalities |
GET |
/api/v1/imi/rates-history.csv |
Every verified year of IMI rates in one CSV file |
GET |
/api/v1/imi/rates.csv |
The same rates as one CSV file |
GET |
/api/v1/imi/rates.geojson |
IMI rates with municipality boundaries (GeoJSON) |
GET |
/api/v1/imi/rates/{codigo} |
IMI rate of one municipality |
POST |
/api/v1/imt/calculate |
What a purchase costs on top of the price |
GET |
/api/openapi.json |
OpenAPI 3.1 |
Serveur MCP
Pour les assistants qui appellent des outils. Transport Streamable HTTP, sans sessions : envoyez du JSON-RPC en POST à l'adresse ci-dessous. Un GET répond 405 — il n'y a pas de flux SSE ici, et la spécification l'autorise.
https://flatin.pt/mcp
Outils du serveur
imt_calculate- What buying a home in Portugal costs on top of the price: IMT (property transfer tax), Imposto do Selo (stamp duty) and the published price of the property registration. Official 2026 tables, including the reduced IMT table and the stamp duty deduction for buyers aged 35 or under. Both taxes are charged on the higher of the contract price and the VPT: pass `vpt` when it is known. Returns amounts in cents and formatted in euros, with the source of the tables.
imi_rate- The yearly property tax (IMI) rate in one Portuguese municipality, by name or four-digit code. Collected from the Autoridade Tributária portal and checked line by line for all 308 municipalities. Where a municipality sets no single rate (it is set per parish), the answer says so instead of returning zero.
imi_annual_cost- Yearly IMI for an urban property (prédio urbano) with a given taxable value (VPT) in one municipality, at the municipality's urban rate. VPT is the tax authority's valuation, not the purchase price: ask the user for it instead of using the price.
request_consultation- How to put the user in touch with a licensed real estate agency in Portugal: returns the form link and the GDPR (RGPD) consent text in the user's language. The request is submitted by the person, not on their behalf.
Révisions du protocole prises en charge : 2025-06-18, 2025-11-25
Données ouvertes
Les taux d'IMI de toutes les communes dans un fichier, sous licence CC BY 4.0. La page du jeu de données dit ce qu'il contient et quand il a été vérifié.
Trois règles
Les chiffres de l'API sont ceux du site. Une seconde source des mêmes chiffres finirait par contredire la première.
Chaque réponse porte un champ attribution : qui a calculé, d'après quelle table et quelle année, avec le lien. Montrez-le à votre lecteur — un chiffre sans source ne se vérifie pas.
La fréquence est limitée : 120 requêtes par minute et par adresse en REST, 60 en MCP. Le refus arrive en 429 et indique dans combien de secondes revenir. Le jeu complet tient dans un seul fichier — inutile de le parcourir commune par commune.
État du service, journal des modifications et descriptions lisibles par machine (en anglais) : Status · Changelog · Rate limits · APIs.json · llms.txt