flatin.pt — Portuguese homes: new-builds, places, taxes

Quality 75 / 100good

12 tools, about 6,020 tokens to load them all · tool set e0fca6329e59 · tools last changed 2026-10-19 · checked 2026-10-19 13:05 UTC

Tool changes

• 2026-10-19get_newbuildchangeddescription, input schema, output schemameaning changed
  before

  One new-build project in Portugal: prices, cost to buy, what is nearby. Units and prices per typology with price history, construction stage, delivery promises and how often they moved, linked building permits, the developer, the full purchase cost at the cheapest available price (IMT, stamp duty, registration, with the municipality's IMI rate) and nearby transport, schools, health, shops and parks. Returns the page URL in each of the seven site languages; cite it.

  after · 45% of words in common

  Returns one new-build project in Portugal by slug 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. Use it after `search_newbuilds`, which gives the slug. The purchase cost is at the cheapest available unit or the developer's from-price, for a buyer tax resident in Portugal; for a non-resident or another price use `imt_calculate`. `primary_home` and `buyer_is_young` change only the purchase cost. An unknown slug is refused (not_found). Cite the page URL, given in all seven site languages.

• 2026-10-19search_newbuildschangeddescription, input schema, output schemameaning changed
  before

  Find new-build housing projects (empreendimentos) in Portugal on flatin.pt. Filter by municipality, parish, typology T0–T5, budget, construction stage, delivery year and energy class. Each result has the price range per typology, stage, promised delivery date, developer, coordinates and the canonical page URL to cite. Prices come from developers' pages with the date they were checked. Use get_newbuild for one project's units, purchase cost and surroundings.

  after · 39% of words in common

  Searches the published new-build projects (empreendimentos) in Portugal on flatin.pt. Use it to find projects; for one project's units, purchase cost and surroundings use `get_newbuild` with its slug, and for how much is being built in a municipality `construction_barometer`. With `typology`, the budget applies to those typologies' prices; projects without a published price drop out when a budget is given. Pass next_offset as `offset` for the next page. A misspelt filter is refused, not ignored. Prices are as checked on developers' pages or agency listings, with the date.

• 2026-10-19glossary_lookupchangeddescription, input schema, output schemameaning changed
  before

  A Portuguese home-buying or tax term explained, with the law. From the flatin.pt glossary (CPCV, escritura pública, caderneta predial, VPT, IMT, IMI, AIMI, certidão permanente…): what it means, where it comes up when buying, and the article of law with a link to the official text and the date it was checked. In the user's language. Call without `term` to list all terms.

  after · 47% of words in common

  Explains a Portuguese home-buying or tax term (CPCV, escritura, VPT…) from the flatin.pt glossary. It gives what the term means, where it comes up when buying, and the article of law with a link to the official text. Use it to define a term; it calculates nothing: for purchase taxes use `imt_calculate`, for the yearly tax `imi_annual_cost`. Without `term` it lists all terms. A term without a translation comes in English; an unknown one is refused with close spellings, if any.

• 2026-10-19construction_barometerchangeddescription, input schema, output schema
  before

  How much is being built, by municipality. flatin.pt's monthly count of municipal building-works cases entering the licensing pipeline (for the municipalities we collect), the change on the previous 12 months and per 1,000 residents, plus INE's official yearly licensed buildings and new dwellings for any of the 308 municipalities. Without `municipality` returns the summary and the panel index. A case is not a licence granted and not a building — the answer says so.

  after · 50% of words in common

  Reports how much is being built in Portuguese municipalities. It gives flatin.pt's monthly count of building-works cases entering licensing, for the municipalities we collect, and INE's yearly licensed buildings and new dwellings for any of the 308. Use it for building activity; for a municipality's other figures use `municipality_stats`, and for new-build projects with prices `search_newbuilds`. Without `municipality` it returns every municipality we collect and the fixed-panel index. `measure` and `granularity` change only our own series. A case is not a licence granted and not a building.

• 2026-10-19compare_municipalitieschangeddescription, input schema, output schemameaning changed
  before

  Two to five municipalities side by side. The same figures as municipality_stats: IMI rate, INE median sale price per m², purchasing power, population, licensed new dwellings, construction activity, new-build developments, with source and date for each.

  after · 22% of words in common

  Compares two to five Portuguese municipalities side by side, with the same figures for each as `municipality_stats`. Use it when choosing between places; for a single municipality use `municipality_stats`, and 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.

• 2026-10-19municipality_statschangeddescription, input schema, output schema
  before

  Key figures for one of Portugal's 308 municipalities. IMI rate and its history (Autoridade Tributária), INE median sale price per m² (actual sales, not asking prices), purchasing power and population, INE licensed buildings and new dwellings by year, municipal building-works cases by year where we collect them, the construction-barometer row, new-build developments in our catalogue, and the where-to-live guide if there is one. Every figure has its source and date; a figure that is not published is null, not estimated.

  after · 55% of words in common

  Returns the key figures of one of Portugal's 308 municipalities, with the source and date of each official figure. They are the IMI rate and history, INE median sale price per m² (actual sales, not asking prices), purchasing power, population, licensed new dwellings, building-works cases and our new-build count. Use it for one municipality; to compare two to five use `compare_municipalities`, for areas inside a city `where_to_live`, and for building activity by month `construction_barometer`. A figure that is not published is null, not estimated. A name matching two municipalities is refused with candidates.

• 2026-10-19where_to_livechangeddescription, input schema, output schemameaning changed
  before

  Where to live in a Portuguese city or region, area by area. The verdict of a flatin.pt guide for each area — live (good to live), depends (depends on you) or avoid (we advise against) — with the reason as written on the site, who it suits (families, no car, retirees, remote work, tight budget, nightlife) and the sources of its numbers. Also noise in plain words (festivals, bars, aircraft under approach paths) and safety as dated, sourced police operations — the local reputation of a place, never a claim about the people who live there. Call without `city` to list the cities that have a guide. Returns the guide's link: show it to the user.

  after · 44% of words in common

  Gives a flatin.pt city guide's verdict on where to live, area by area, with the reason, who each area suits and the sources. Use it to choose a neighbourhood; for one municipality's figures use `municipality_stats`, and for new homes there `search_newbuilds`. Without `city` it lists the cities and regions that have a guide. `profile` narrows 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.

• 2026-10-19subscribe_digestchangeddescription, input schema, output schemameaning changed
  before

  Email the person new developments or new construction licences (double opt-in). New-build developments match a filter (city, typology, price; daily), or newly licensed construction in a municipality (weekly). Ask the person first: this only sends a confirmation email, and nothing is active until they click the link. One-click unsubscribe in every email.

  after · 38% of words in common

  Subscribes the person's email to new-build projects matching a filter (daily) or to new construction licensed in one municipality (weekly), by double opt-in. Use it when the person asks to be told about new projects; to have an agency contact them use `request_consultation`, and to see what is on sale now `search_newbuilds`. Ask the person first: it only sends a confirmation email, and nothing is active until they click its link. `city` is required for construction and `parish` works only there; `typology`, the prices and `on_sale` work only with new_developments. The answer is the same whether or not the address was already subscribed: never tell the person they were.

• 2026-10-19request_consultationchangeddescription, input schema, output schema
  before

  Send the person's request to a licensed real estate agency (AMI) in Portugal, after their explicit consent. It is about buying or selling a home or a new-build development. Two steps: call with mode=prepare and their details (name, phone with preferred channel or else email, city or project, language); show them the returned summary and the GDPR (RGPD) consent text word for word, and only if they explicitly agree call with mode=submit, the same details, confirmation_token, consent=true and consent_text_version. Never set consent=true on your own. mode=link (default) only returns the form link.

  after · 51% of words in common

  Passes the person's request to buy or sell a home in Portugal to a licensed real estate agency (AMI), only with their explicit consent. Use it when the person wants a specialist to contact them; for emails about new projects use `subscribe_digest`. mode=link only 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; neither sends anything. Show the person the summary and the consent text word for word; only if they explicitly agree, call mode=submit with the same details, the token, consent=true and consent_text_version. Never set consent=true on your own. Changed details, a token younger than 5 seconds or older than 30 minutes, or an outdated consent version are refused. A submit that goes through returns status received.

• 2026-10-19imi_annual_costchangeddescription, input schema, output schemameaning changed
  before

  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.

  after · 45% of words in common

  Calculates the yearly IMI on an urban property (prédio urbano) from its taxable value (VPT) and the urban rate of its municipality. Use it for the yearly amount; for the rate alone use `imi_rate`, and for the one-off purchase taxes `imt_calculate`. The VPT is the Tax Authority's valuation on the caderneta predial, not the purchase price: ask the user for it rather than using the price. 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).

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.