API, MCP e dados abertos
Os mesmos dados que estão no site, legíveis por máquina: empreendimentos novos com preços por tipologia e prazos, guias de onde viver, números de cada município (INE), o barómetro da construção, IMT e Imposto do Selo na compra, taxas de IMI dos 308 municípios. Sem chave e sem registo.
Atualizado em
API HTTP
JSON sobre HTTPS, sem autenticação. O esquema OpenAPI está no fim desta lista e é lido por ferramentas.
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/construction-barometer |
Construction barometer: building-works cases and INE licences |
POST |
/api/v1/consultation |
Send a request to flatin.pt, a licensed estate agency (two steps) |
GET |
/api/v1/facts.json |
Dated facts about Portugal, each with its primary source |
GET |
/api/v1/funnel |
Housing pipeline by municipality: cases, licences, completions |
GET |
/api/v1/funnel.csv |
Housing pipeline of the 308 municipalities, as CSV |
GET |
/api/v1/glossary |
Glossary of Portuguese home-buying terms: the list |
GET |
/api/v1/glossary/{term} |
One glossary term: definition, law reference and page |
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/v1/licensing-duration |
Age of licensing cases in progress: Porto and Lisbon |
GET |
/api/v1/licensing-duration.csv |
Age of licensing cases in progress, as CSV |
POST |
/api/v1/mortgage/calculate |
Mortgage payment, minimum income and cash at the deed |
GET |
/api/v1/municipalities/compare |
Compare 2 to 5 municipalities side by side |
GET |
/api/v1/municipalities/{municipality}/stats |
Everything flatin.pt publishes about one municipality |
GET |
/api/v1/newbuilds |
Search new-build projects in Portugal |
GET |
/api/v1/newbuilds/{slug} |
One new-build project: prices, status, purchase cost, nearby |
GET |
/api/v1/open-data-coverage |
The same open-data index as JSON, with attribution |
GET |
/api/v1/open-data-coverage.csv |
Open data of the 308 municipalities: what each one publishes |
GET |
/api/v1/reports/obra-nova.json |
Monthly report 'Obra nova em Portugal': list of editions |
GET |
/api/v1/reports/obra-nova/{edition}.csv |
One edition of the monthly new-build report as CSV |
GET |
/api/v1/reports/obra-nova/{edition}.json |
One edition of the monthly new-build report as JSON, with attribution |
POST |
/api/v1/subscriptions |
Subscribe an email to new developments or construction |
GET |
/api/v1/where-to-live |
Where-to-live guides: the list of cities and regions |
GET |
/api/v1/where-to-live.csv |
Where to live in Portugal: the city guides compared, as CSV |
GET |
/api/v1/where-to-live/{city} |
Where to live in a city: verdict by area, noise and safety |
GET |
/api/openapi.json |
OpenAPI 3.1 |
Servidor MCP
Para assistentes que chamam ferramentas. Transporte Streamable HTTP, sem sessões: envie JSON-RPC por POST para o endereço abaixo. Um GET responde 405 — não há stream SSE aqui.
https://flatin.pt/mcp
Ferramentas do servidor
imt_calculate- Use this when asked what a home purchase in Portugal costs on top of the price: IMT, stamp duty and Casa Pronta registration, by the 2026 tables. Do not use it for the yearly property tax (
imi_annual_cost) or to define a term such as VPT (glossary_lookup). Both taxes are charged on the higher ofvalueandvpt: pass the VPT when known.tax_haven_companytakes precedence overnon_resident.buyer_is_youngapplies only whenprimary_homeis true. For a non-resident buyer the answer says what the Tax Authority annuls later on request. required_income- Use this when asked what net monthly income and savings it takes to buy a home in Portugal at a given price, under the Banco de Portugal rules. Do not use it for the purchase taxes alone (
imt_calculate). imi_rate- Use this when only the yearly IMI (municipal property tax) rate of one Portuguese municipality is needed, by name or code, with its history by year. Do not use it for the yearly amount on a VPT (
imi_annual_cost) or for several municipalities side by side (compare_municipalities). Rates: Autoridade Tributária portal, all 308 municipalities. Where the rate is set per parish, the answer says so instead of giving a number. imi_annual_cost- Use this when the yearly IMI amount on an urban property (prédio urbano) is needed, from its taxable value (VPT) and its municipality's urban rate. Do not use it for the rate alone (
imi_rate) or for the one-off purchase taxes (imt_calculate). The VPT is the Tax Authority's valuation on the caderneta predial, not the price: ask the user for it. Only the urban rate is applied; rural property, AIMI and surcharges on vacant homes are not calculated. A municipality whose rate is set per parish is refused (rate_by_freguesia). request_consultation- Use this when the person wants flatin.pt (licensed estate agency, AMI 28163) to contact them about buying a new-build apartment in Portugal. Do not use it to send the request (
submit_consultation) or for emails about new projects (subscribe_digest). mode=link returns the form link and the consent text; mode=prepare checks the details and returns a summary, the GDPR (RGPD) consent text and a confirmation_token. Nothing is sent. submit_consultation- Use this when the person has read the summary and consent text from
request_consultationmode=prepare and explicitly agreed to send the request. Do not use it before that (request_consultation). Pass the same details, the token, consent=true and consent_text_version; never set consent=true on your own. Changed details, a token under 5 seconds or over 30 minutes old, or an outdated consent version are refused. subscribe_digest- Use this when the person asks to be emailed about new-build projects matching a filter (daily) or new construction licensed in one municipality (weekly). Do not use it to have flatin.pt contact them (
request_consultation) or to see what is on sale now (search_newbuilds). Ask the person first; nothing is active until they click the confirmation email.cityis required for construction andparishworks only there;typology, the prices andon_salework only with new_developments. The answer is the same whether or not the address was already subscribed: never say it was. where_to_live- Use this when the person is choosing a neighbourhood: a flatin.pt city guide's verdict area by area, with the reason, who each area suits and the sources. Do not use it for one municipality's figures (
municipality_stats) or for new homes there (search_newbuilds). Withoutcityit lists the cities and regions that have a guide.profilenarrows the areas but never hides the ones we advise against. Noise and safety come as dated, sourced facts: a place's reputation, never a claim about its people. Show the guide's link to the user. municipality_stats- Use this when the key figures of one of Portugal's 308 municipalities are needed, each with its source and date. They are the IMI rate and history, INE sale price per m² (actual sales), purchasing power, population, licensed dwellings, building cases, new builds. Do not use it to compare places (
compare_municipalities), inside a city (where_to_live) or for monthly building (construction_barometer). A figure that is not published is null, not estimated. A name matching two municipalities is refused with candidates. compare_municipalities- Use this when the person is choosing between two to five Portuguese municipalities, with the same figures for each as
municipality_stats. Do not use it for a single municipality (municipality_stats) or for the areas inside one city (where_to_live). Names that point at the same municipality count once, and fewer than two distinct ones are refused (bad_count). One unknown or ambiguous name refuses the whole comparison. construction_barometer- Use this when the question is how much is being built in Portuguese municipalities. It gives our monthly count of building-works cases entering licensing, where we collect them, and INE's yearly licensed buildings and new dwellings for all 308. Do not use it for other figures (
municipality_stats). Withoutmunicipalityit returns every municipality we collect and the panel index.measureandgranularitychange only our own series. A case is not a granted licence or a building. municipality_housing_pipeline- Use this when one municipality's housing pipeline from licence to completion is needed: cases, INE licences and completions, units for sale. Do not use it for monthly building activity (
construction_barometer). Periods differ by stage; unknown is null, not 0. glossary_lookup- Use this when asked what a Portuguese home-buying or tax term means (CPCV, escritura, VPT…), with where it comes up and the article of law with a link. Do not use it to calculate anything: purchase taxes are
imt_calculate, the yearly taximi_annual_cost. Withouttermit lists all terms. A term without a translation comes in English; an unknown one is refused with close spellings, if any. search_newbuilds- Use this when the person wants to find published new-build projects (empreendimentos) in Portugal on flatin.pt. Do not use it for one project's details (
get_newbuildwith its slug) or for how much is being built (construction_barometer). Withtypology, the budget applies to those typologies' prices; projects without a published price drop out when a budget is given. Pass next_offset asoffsetfor the next page. A misspelt filter is refused, not ignored. Prices are as checked on developers' pages or agency listings, dated. get_newbuild- Use this when one new-build project in Portugal is needed in detail, by slug (from
search_newbuilds) or page URL. It gives units and prices per typology, price history, delivery promises and how often they moved, building permits, the developer, the purchase cost and what is nearby. Do not use it to search (search_newbuilds) or for taxes at another price or for a non-resident (imt_calculate). The purchase cost is at the cheapest available unit or the developer's from-price, for a buyer tax resident in Portugal.primary_homeandbuyer_is_youngchange only the purchase cost. An unknown slug is refused (not_found). Cite the page URL, given in all seven site languages.
Duas ações são feitas em nome da pessoa. O pedido ao flatin.pt (licença AMI n.º 28163) passa por duas ferramentas: request_consultation com mode=prepare devolve o texto de consentimento e um código, sem enviar nada; submit_consultation envia o pedido com esse código, consent=true e a versão do texto, só depois de a pessoa ler o texto e concordar. subscribe_digest só envia um e-mail de confirmação — nada fica ativo antes do clique. As mesmas ações em REST: POST /api/v1/consultation e POST /api/v1/subscriptions.
Revisões do protocolo suportadas: 2025-06-18, 2025-11-25
Dados abertos
As taxas de IMI de todos os municípios num ficheiro, sob licença CC BY 4.0. A página do conjunto de dados explica o que está dentro e quando foi conferido.
- CSV 308 · 2025
- Taxas de IMI de todos os municípios, em dados abertos
- Taxas de IMI dos 308 municípios: dados para jornalistas
Também publicado em dados.gov.pt · data.europa.eu
Barómetro da construção
O nosso próprio indicador mensal: quantos processos de obras de edificação entram no procedimento de licenciamento de cada câmara municipal. Um processo conta à entrada do procedimento; ainda pode ser indeferido ou retirado, ou nunca chegar a obra. Ao lado ficam, para comparação, duas estatísticas de outros editores, espelhadas tal como são publicadas. A cobertura é parcial e vai crescendo; a metodologia explica o que se conta.
barometer/series.csv- A flatin.pt conta esta série a partir dos dados abertos das próprias câmaras e publica-a sob CC BY 4.0. Crédito: flatin.pt, com ligação para flatin.pt. Texto da licença: CC BY 4.0
barometer/official.csv- A série oficial com que o barómetro é aferido, espelhada sem alterações. Fonte: INE — Instituto Nacional de Estatística, Portugal, sob licença CC BY 4.0. Ao reutilizar estes números, indique esta fonte. Texto da licença: CC BY 4.0
barometer/sce.csv- Estatística de certificados energéticos de habitação nova, por mês e por concelho, espelhada sem alterações: pré-certificados em fase de projeto e certificados de edifícios concluídos. O pré-certificado é emitido para cada fogo na fase de projeto, antes da licença de construção. Indique a fonte: ADENE — SCE. O editor não declara licença para esta estatística, e nós não concedemos nenhuma.
open-data-coverage.csv- Dados abertos de urbanismo nos 308 concelhos — estado da publicação. CC BY 4.0
A nossa série é guardada em instantâneos, e cada resposta traz a data do instantâneo de onde saiu. Cite essa data e o número continua reproduzível depois de a série ser revista.
- Barómetro da construção por concelho
- Metodologia do barómetro
- Do licenciamento à obra concluída, concelho a concelho
- Dados abertos de urbanismo nos 308 concelhos
- Condições de utilização
Também publicado em dados.gov.pt · data.europa.eu
Três regras
Os números da API são os mesmos que estão no site.
Cada resposta traz o campo attribution: quem calculou, por que tabela e de que ano, com ligação. Mostre-o a quem lê.
A frequência é limitada: 120 pedidos por minuto por endereço no REST e 60 no MCP. A recusa chega com o código 429 e diz dentro de quantos segundos voltar. Todo o conjunto sai num ficheiro só — não é preciso percorrê-lo município a município.
Estado do serviço, histórico de alterações e descrições para máquinas (em inglês): Status · Changelog · Rate limits · APIs.json · llms.txt