Search new-build projects in Portugal
search_newbuildsUse 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_newbuild with its slug) or for how much is being built (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, dated.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"typology": [
"T2"
],
"price_max": 400000,
"municipality": "Porto"
},
"name": "search_newbuilds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | price: cheapest first; delivery: soonest first; new: recently added first. Projects with a price always come before those without | price |
| limit | No | Results per call | |
| stage | No | Construction stage: planned, licensed, building (under construction), selling (on sale), delivered (completed) | |
| offset | No | Skip this many results: pass next_offset from the previous answer | |
| parish | No | Parish (freguesia) name. Exact name, accents optional | |
| on_sale | No | Only projects with a published price | |
| language | No | Language of the page URLs and of the labels (stage, typology, nearby places); the text summary shows the typology labels in it. Field names stay English. uk is accepted as ua. | en |
| typology | No | Bedrooms: T0 studio … T5 (five or more). Any of the listed matches | |
| price_max | No | Budget upper bound in euros, e.g. 350000. With typology, the budget applies to those typologies' prices. Projects with no published price are left out when a budget is given | |
| price_min | No | Budget lower bound in euros | |
| delivery_by | No | Completed, or promised for this year or earlier (overdue promises included), e.g. 2027; at most five years back. Projects with no announced date are left out | |
| energy_class | No | Energy certificate class of at least one unit, as stated by the source. Often not published: filter only when asked | |
| municipality | No | City / municipality (concelho): name, slug or four-digit code, e.g. Porto, Lisboa, Vila Nova de Gaia, Matosinhos, 1312. English names (Lisbon) and accents-free spelling are understood; an ambiguous name (Lagoa) is refused with candidates |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||