dils.pt APIdils.pt ↗
Access Dils Portugal (Castelhana) listings via API. Get development details, unit fractions, prices, floor data, and amenities across Lisboa, Porto, and Algarve.
curl -X GET 'https://api.parse.bot/scraper/5cefcd8e-a310-4e05-8ee4-1a7be6a36759/list_developments?page=1&page_size=3' \ -H 'X-API-Key: $PARSE_API_KEY'
List all real estate developments with pagination. Returns development summaries including name, location, typologies, price ranges, availability, features, images, and agent contacts.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| page_size | integer | Number of results per page. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"total": "integer - number of developments returned on this page",
"page_size": "integer - requested page size",
"developments": "array of development summary objects with id, name, description, type, status, location fields, typologies, price range, features, agents, and images"
},
"sample": {
"data": {
"page": 1,
"total": 3,
"page_size": 3,
"developments": [
{
"id": 25854083,
"name": "Vistabella",
"type": "Prédio",
"year": null,
"zone": "Oeiras (Oeiras e São Julião Barra)",
"agents": [
{
"name": "Dils Company",
"email": "[email protected]",
"phone": "+1 (555) 012-3456"
}
],
"images": [
{
"original": "https://images.egorealestate.com/ZOriginal/...",
"thumbnail": "https://images.egorealestate.com/Z512x384/...",
"description": "Fachada"
}
],
"parish": "Oeiras e São Julião da Barra, Paço de Arcos e Caxias",
"status": "Em construção",
"address": "",
"country": "Portugal",
"gps_lat": 38.707,
"gps_lon": -9.308,
"district": "Lisboa",
"features": [
"AREAS",
"AREA_T",
"BEACH"
],
"zip_code": "",
"max_price": "1 650 000 €",
"min_price": "542 996 €",
"reference": "38125",
"thumbnail": "https://images.egorealestate.com/Z512x384/...",
"area_range": [
78,
185
],
"price_info": null,
"typologies": [
"T1",
"T2",
"T3"
],
"description": "O Vistabella é um novo conceito residencial...",
"availability": "Disponível",
"municipality": "Oeiras",
"last_modified": "2026-05-14T21:13:06",
"typology_range": [
"T1",
"T4"
],
"total_fractions": 25,
"available_fractions": 24
}
]
},
"status": "success"
}
}About the dils.pt API
The Dils Portugal API covers 3 endpoints that expose real estate development listings from dils.pt, formerly known as Castelhana, across Lisboa, Porto, Algarve, Cascais, Oeiras, and Comporta. Use list_developments to paginate through all active developments with price ranges and typologies, get_development_detail to retrieve full metadata for a single project, or get_development_fractions to pull individual unit-level data including floor, area, bathrooms, and energy certification.
What the API Returns
The API exposes structured data from dils.pt, one of Portugal's major new-development real estate portals. list_developments returns paginated summaries — each record includes id, name, description, type, status, location fields, typologies, price range, features, and agent contact information. The page, total, and page_size fields in the response make it straightforward to iterate through the full catalogue.
Development Detail and Unit-Level Data
get_development_detail accepts a development_id (obtained from list_developments) and returns the full project record: district, status, min_price, max_price, images (with thumbnail, original, and description), and an array of features tags. Setting include_fractions=true attaches all unit records to the same response, avoiding a second round-trip. For larger developments where you only need unit data, get_development_fractions returns a dedicated fractions array with per-unit fields: typology, floor, bathrooms, useful_area, gross_area, availability, energy_certification, plus images and blueprints.
Coverage and Scope
Coverage spans Portugal's primary new-development markets: Lisboa, Porto, Algarve, Cascais, Oeiras, and Comporta. All three endpoints reflect the development and unit inventory currently listed on dils.pt. Fraction-level fields like energy_certification and gross_area are particularly useful for compliance checks or comparative analysis across units within the same building.
- Build a Portugal new-development property search tool filtered by district, typology, and price range using
list_developmentsresponse fields. - Track price range changes across developments over time by periodically calling
get_development_detailand storingmin_priceandmax_price. - Display floor plan images and blueprints for individual units by consuming the
imagesarray fromget_development_fractions. - Calculate average useful area per typology across a region by aggregating
useful_areaandtypologyfields from fraction records. - Filter available units in a specific development by
availabilityandenergy_certificationfor clients with sustainability requirements. - Populate a CRM or property alert system with agent contact data and availability status from
list_developmentssummaries. - Generate a comparative report of gross vs. useful area ratios across fractions in a single development using
get_development_fractions.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Dils Portugal have an official public developer API?+
What does `get_development_fractions` return that `get_development_detail` with `include_fractions=true` does not?+
get_development_fractions returns the same fraction-level fields — typology, floor, bathrooms, useful_area, gross_area, availability, energy_certification, images, and blueprints — but as a standalone call. Using include_fractions=true on get_development_detail bundles fractions into the full development record in one response. For large developments, the dedicated fractions endpoint may be cleaner if you only need unit data without re-fetching all development metadata.How does pagination work in `list_developments`?+
page (1-indexed integer) and page_size parameters. The response includes page, page_size, and total fields — note that total reflects the count of developments returned on that page, not the overall catalogue size. You will need to iterate pages until a page returns fewer results than page_size to detect the end of the list.Does the API expose secondary-market (resale) listings or only new developments?+
Are price fields returned as numbers or formatted strings?+
min_price and max_price in get_development_detail are returned as formatted strings (e.g. '€ 450,000'). If you need numeric values for sorting or computation, you will need to parse out the numeric portion after fetching. Fraction-level records from get_development_fractions should be checked per response for their price field format.