API, MCP і відкриті дані
Ті самі числа, що на сайті, машинозчитувано: IMT і гербовий збір при купівлі, ставки IMI по всіх 308 муніципалітетах. Без ключа і без реєстрації.
Оновлено
HTTP-API
JSON поверх HTTPS, без автентифікації. Схема OpenAPI — наприкінці списку, її і читають інструменти.
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 |
MCP-сервер
Для асистентів, які викликають інструменти. Транспорт Streamable HTTP, без сесій: надсилайте JSON-RPC методом POST на адресу нижче. На GET приходить 405 — потоку SSE тут немає, і специфікація це дозволяє.
https://flatin.pt/mcp
Інструменти сервера
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.
Підтримувані ревізії протоколу: 2025-06-18, 2025-11-25
Відкриті дані
Ставки IMI всіх муніципалітетів одним файлом під ліцензією CC BY 4.0. Сторінка набору даних розповідає, що всередині і коли числа звіряли.
Три правила
Числа в API — ті самі, що на сайті. Друге джерело тих самих чисел колись розійшлося б із першим.
У кожній відповіді є поле attribution: хто порахував, за якою таблицею і якого року, з посиланням. Показуйте його читачеві — число без джерела перевірити не можна.
Частота обмежена: 120 запитів за хвилину з адреси в REST і 60 у MCP. Відмова приходить кодом 429 і каже, за скільки секунд повернутися. Увесь набір віддається одним файлом — обходити його по одному муніципалітету не треба.
Статус сервісу, журнал змін і описи для машин (англійською): Status · Changelog · Rate limits · APIs.json · llms.txt