# Belgium EPC Distress Leads — E/F/G Energy-Sieve Property Feed (`studio-amba/belgium-epc-distress-leads`) Actor

Find EPC E, F and G property listings (energy sieves) in Belgium. Runs Immoweb, 2dehands, Immovlan and Zimmo, keeps only energy-sieve listings, attaches a region-specific renovation-obligation urgency flag (Flanders/Wallonia/Brussels), dedupes across portals, and flags private-owner vs agency.

- **URL**: https://apify.com/studio-amba/belgium-epc-distress-leads.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Belgium EPC Distress Leads — E/F/G Energy-Sieve Property Feed

Find **EPC E, F and G property listings** ("energy sieves") across the main Belgian real-estate portals in one run. Belgium EPC Distress Leads runs Immoweb, 2dehands, Immovlan and Zimmo, keeps only the worst-rated listings, attaches a **region-specific renovation-obligation urgency flag** (Belgium has no single national rule — Flanders, Wallonia and Brussels each run their own), deduplicates the same property across portals, and flags each result as sold by a **private owner** or by an **agency**.

These are motivated sellers: Flanders and Wallonia are both phasing in binding renovation obligations that make an unrenovated energy sieve expensive to keep.

### Why E/F/G listings are distress leads

Belgium has three regions, three EPC/PEB certificate systems, and three different renovation timelines:

- **Flanders** — a buyer of an E or F home (any notarial deed since 1 January 2023) must renovate it to at least label D within 6 years (5 years for deeds signed before 1 January 2026). This is set in the Energiedecreet and enforced by VEKA, with fines from €500 to €5,000 for non-compliance. The obligation sits on the buyer, not the seller — which is exactly why it makes a motivated buyer's counterpart (the current owner trying to sell before the clock resets on someone else) worth reaching early.
- **Wallonia** — a binding PEB renovation calendar adopted in late 2025 requires a buyer of an F-label property to reach D on a schedule tied to the purchase year, tightening toward label A by 2050. G-label rentals are already banned since 1 January 2025.
- **Brussels** — no purchase-triggered renovation obligation exists yet. Every dwelling will need a PEB certificate by 2031, but that's a weaker signal than the other two regions, and this actor flags it as such rather than treating it as a binding rule.

An owner of an E/F/G property who understands the buyer-side obligation coming their way often prices to move rather than gamble on a slower sale. That makes an E/F/G listing a distress signal, and one **sold directly by its owner (FSBO)** the premium lead — reachable without an agency mandate.

### What it does

- **EPC E/F/G filter.** Every returned row is a listing resolved to your chosen grades (default E, F and G). Listings without a resolvable grade are excluded by design — see Documented limits below for exactly which sources that affects.
- **Region-specific urgency flag.** Each row carries `epcUrgency`, resolved from the postal code, mapping the grade to the correct regional obligation.
- **Cross-portal dedup.** The same property on more than one portal is merged into one row using a content fingerprint (postcode + property type + surface, then price proximity). No shared listing ID exists between Belgian portals.
- **FSBO vs agency classification.** 2dehands is the FSBO anchor (a general classifieds marketplace where an absence of agency keywords signals a private seller); Immoweb, Immovlan and Zimmo carry an explicit agency name when the listing is professional. Every row is labelled `particulier`, `professionnel`, or `unknown`.
- **New-listing delta.** Turn on "only new since last run" and each run returns only distress properties not seen before, backed by a per-account store.
- **Optional agency enrichment.** Cross-reference agency-listed properties against the Belgian KBO/BCE company registry to attach agency phone and enterprise number.

### How to scrape Belgian EPC E/F/G property data

1. Enter a **location** (city) and its **postal code** — e.g. `Gent` / `9000`, `Antwerpen` / `2000`, `Charleroi` / `6000`.
2. Keep the default **EPC grades** E, F and G, or narrow to just F/G.
3. Choose **sale** or **rent**.
4. Pick your **portals** — all four run by default for the best cross-portal dedup and FSBO signal.
5. Set a **Belgian residential proxy** (default input is already configured for one — Immoweb and Zimmo are anti-bot-protected and 403 without it).
6. Optionally set **seller filter** to `FSBO leads only`, or turn on **only new listings**.
7. Run it. Each row is one deduplicated distress property with its EPC grade, region, renovation urgency, FSBO classification, price, surface, price per m², and per-portal source links.

Schedule the actor with "only new since last run" enabled to receive a rolling feed of fresh E/F/G distress leads for your sector.

### Portals and reliability (method disclosure)

| Portal | Method | Reliability | EPC coverage |
|---|---|---|---|
| **Immoweb** | JSON API (classified endpoint) | High | Numeric kWh/m²/year score from the certificates field. Resolved to a letter grade only when the postal code is in Flanders (VEKA banding) — see limits. Needs a Belgian residential proxy. |
| **Zimmo** | Playwright + Cloudflare | Medium | Explicit letter grade parsed from the EPC badge image filename. Works in every region. Needs a Belgian residential proxy. |
| **Immovlan** | Browser (Akamai-protected) | Medium | No EPC field exposed. |
| **2dehands** | Public API | Medium | No EPC field exposed (general classifieds, not a structured real-estate listing). |

The run degrades gracefully: if a portal fails, the run continues with the others and records which succeeded in the run summary.

### Documented limits

- **EPC coverage is not 100%.** Only Immoweb and Zimmo expose an EPC value at all. Immovlan and 2dehands listings can still be part of a deduped property (contributing price, surface, or the FSBO signal), but they never supply the grade themselves — a property has a grade only if Immoweb or Zimmo also carried a listing for it.
- **Immoweb's numeric score only resolves in Flanders.** Wallonia and Brussels run different kWh-to-label bands that aren't built into this actor. A numeric Immoweb score outside Flanders is left unresolved (`epcGrade: null`) rather than mislabeled with the wrong region's scale — those rows are excluded from the default filter. Zimmo's letter grade is unaffected and works everywhere.
- **2dehands-exclusive FSBO leads never carry an EPC grade.** Because 2dehands exposes no EPC field, a property that is genuinely private-seller-exclusive (only on 2dehands, not cross-listed on Immoweb or Zimmo) has no source for its grade and is excluded by the EPC filter. FSBO leads that *do* appear in this feed are private sellers who also listed (or were matched) on Immoweb or Zimmo.
- **Region is inferred from the postal code**, using the standard Belgian postcode-to-province mapping. It is a reliable heuristic, not an official region lookup.
- **No shared listing ID.** Cross-portal matching is content-based (postcode + type + surface + price), high-precision but not exhaustive.
- **Grade G doesn't exist in Flanders.** The Flemish EPC scale tops out at F (>500 kWh/m²/year); a `G` filter only ever matches Wallonia/Brussels properties.

### Output fields

Each row is one deduplicated distress property:

- `epcGrade`, `epcUrgency`, `region` — the resolved grade, its regional obligation flag, and the region it was resolved for
- `isFsbo`, `fsboConfidence`, `sellerType` — the FSBO classification
- `isNew`, `firstSeenAt` — the run-over-run delta
- `crossListed`, `portalCount`, `sourcePortals`, `listings[]` — cross-portal presence and per-portal detail
- `priceEur`, `priceMinEur`, `priceMaxEur`, `pricePerM2` — pricing
- `surfaceM2`, `bedrooms`, `propertyType` — the property
- `postalCode`, `city`, `latitude`, `longitude` — location
- `agencyName`, `agencyPhone`, `agencyEnterpriseNumber` — agency detail (phone/enterprise number when enrichment is on)
- `sellerName` — seller detail

### Example output

```json
{
  "epcGrade": "F",
  "epcUrgency": "flanders_renovation_obligation_to_d",
  "region": "flanders",
  "isFsbo": true,
  "sellerType": "particulier",
  "isNew": true,
  "propertyType": "house",
  "listingTitle": "Rijwoning te renoveren, centrum Gent",
  "priceEur": 245000,
  "pricePerM2": 2044,
  "surfaceM2": 120,
  "postalCode": "9000",
  "city": "Gent",
  "sellerName": "Marc",
  "sourcePortals": ["2dehands", "zimmo"]
}
````

### Who uses this

- **Renovation and insulation lead-gen** targeting owners facing the buyer-side renovation obligation.
- **Investors** hunting under-priced E/F/G stock to renovate and relet or resell.
- **Agencies** prospecting distressed owners before a competitor signs the mandate.

### Pricing

Pay per result. You pay for the run start and for each deduplicated distress lead returned. See the pricing tab for current rates.

### FAQ

**Why are some E/F/G properties missing?**
Only properties matched to an Immoweb or Zimmo listing carry a resolvable EPC grade. 2dehands-only and Immovlan-only properties, and Immoweb numeric scores outside Flanders, are excluded so every row is a confirmed distress lead.

**Can I get only the private-seller leads?**
Yes. Set seller filter to `FSBO leads only`. Note that FSBO leads in this feed are cross-listed (also found on Immoweb or Zimmo) because the grade has to come from somewhere — see Documented limits.

**How do I get a feed of only new listings?**
Turn on "only new listings since last run" and schedule the actor.

**Do I need a proxy?**
Yes, a Belgian residential proxy is strongly recommended. The default input is configured for one — Immoweb and Zimmo both 403 datacenter IPs.

**Is the renovation-obligation information legal advice?**
No. The `epcUrgency` flag summarizes public regional rules as of July 2026 for lead-prioritization purposes. Verify current requirements with the relevant regional authority (VEKA in Flanders, SPW in Wallonia, Leefmilieu Brussel) before using it in outreach.

**Is this legal?**
The actor collects publicly listed advertisements. You are responsible for how you use the leads, including Belgian prospection and GDPR rules.

# Actor input Schema

## `location` (type: `string`):

Belgian city to search, e.g. 'Gent', 'Antwerpen', 'Charleroi', 'Brussel'. Drives all selected portals.

## `postalCode` (type: `string`):

4-digit Belgian postal code matching the location. Used to scope 2dehands (which needs a postcode + radius) and to resolve the region (Flanders/Wallonia/Brussels) for the renovation-urgency flag.

## `epcGrades` (type: `array`):

Which EPC grades count as distress. Default E, F and G (the energy sieves under renovation-obligation pressure). Grade G does not occur in Flanders (its scale tops out at F).

## `transactionType` (type: `string`):

Sale (verkoop) or rent (verhuur).

## `propertyType` (type: `string`):

Restrict to one property type. Leave empty for all types.

## `portals` (type: `array`):

Which Belgian portals to run and deduplicate across. Only Immoweb and Zimmo expose an EPC field — 2dehands and Immovlan still contribute to cross-portal dedup and the FSBO signal, but never carry an EPC grade themselves.

## `sellerFilter` (type: `string`):

Return all distress listings, only FSBO (private-owner) ones, or only agency-listed. A private owner of an E/F/G property is the premium lead, but agency-listed distress properties are still valid renovation-lead-gen targets.

## `onlyNew` (type: `boolean`):

Return only distress properties not seen in a previous run. Backed by a per-account key-value store. Leave off for a full snapshot.

## `enrichAgencies` (type: `boolean`):

Cross-reference agency-listed properties against the Belgian KBO/BCE company registry to attach agency phone and enterprise number. Adds extra lookups, so runs take longer. Off by default.

## `minPrice` (type: `integer`):

Lower price bound passed to the portals that support it. Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Upper price bound passed to the portals that support it. Leave empty for no maximum.

## `maxItemsPerSource` (type: `integer`):

Cap on listings pulled from each portal before the EPC filter and dedup. Raise it in areas with fewer E/F/G listings. Immoweb and Zimmo fetch one detail page per item (~10s each), so a high value needs a matching per-portal timeout.

## `timeoutPerSourceSecs` (type: `integer`):

How long to wait for each portal run before treating it as failed. Immoweb/Zimmo detail-page fetches take ~10s per item — keep this above maxItemsPerSource x 10s or those two EPC sources will time out and get excluded.

## `proxyConfiguration` (type: `object`):

Passed through to the child portal scrapers. Belgian residential proxy is strongly recommended — Immoweb and Zimmo are anti-bot-protected and return 403s on datacenter IPs.

## Actor input object example

```json
{
  "location": "Antwerpen",
  "postalCode": "2000",
  "epcGrades": [
    "E",
    "F",
    "G"
  ],
  "transactionType": "sale",
  "propertyType": "",
  "portals": [
    "immoweb",
    "2dehands",
    "immovlan",
    "zimmo"
  ],
  "sellerFilter": "all",
  "onlyNew": false,
  "enrichAgencies": false,
  "maxItemsPerSource": 18,
  "timeoutPerSourceSecs": 220,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "location": "Gent",
    "postalCode": "9000",
    "epcGrades": [
        "E",
        "F",
        "G"
    ],
    "transactionType": "sale",
    "portals": [
        "immoweb",
        "2dehands",
        "immovlan",
        "zimmo"
    ],
    "sellerFilter": "all",
    "maxItemsPerSource": 18,
    "timeoutPerSourceSecs": 220,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "BE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/belgium-epc-distress-leads").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "location": "Gent",
    "postalCode": "9000",
    "epcGrades": [
        "E",
        "F",
        "G",
    ],
    "transactionType": "sale",
    "portals": [
        "immoweb",
        "2dehands",
        "immovlan",
        "zimmo",
    ],
    "sellerFilter": "all",
    "maxItemsPerSource": 18,
    "timeoutPerSourceSecs": 220,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "BE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/belgium-epc-distress-leads").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "location": "Gent",
  "postalCode": "9000",
  "epcGrades": [
    "E",
    "F",
    "G"
  ],
  "transactionType": "sale",
  "portals": [
    "immoweb",
    "2dehands",
    "immovlan",
    "zimmo"
  ],
  "sellerFilter": "all",
  "maxItemsPerSource": 18,
  "timeoutPerSourceSecs": 220,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}' |
apify call studio-amba/belgium-epc-distress-leads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=studio-amba/belgium-epc-distress-leads",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Belgium EPC Distress Leads — E/F/G Energy-Sieve Property Feed",
        "description": "Find EPC E, F and G property listings (energy sieves) in Belgium. Runs Immoweb, 2dehands, Immovlan and Zimmo, keeps only energy-sieve listings, attaches a region-specific renovation-obligation urgency flag (Flanders/Wallonia/Brussels), dedupes across portals, and flags private-owner vs agency.",
        "version": "0.1",
        "x-build-id": "KTOa1mlGs0G2euwCh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/studio-amba~belgium-epc-distress-leads/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-studio-amba-belgium-epc-distress-leads",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/studio-amba~belgium-epc-distress-leads/runs": {
            "post": {
                "operationId": "runs-sync-studio-amba-belgium-epc-distress-leads",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/studio-amba~belgium-epc-distress-leads/run-sync": {
            "post": {
                "operationId": "run-sync-studio-amba-belgium-epc-distress-leads",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "location",
                    "postalCode"
                ],
                "properties": {
                    "location": {
                        "title": "Location (city)",
                        "type": "string",
                        "description": "Belgian city to search, e.g. 'Gent', 'Antwerpen', 'Charleroi', 'Brussel'. Drives all selected portals."
                    },
                    "postalCode": {
                        "title": "Postal code",
                        "type": "string",
                        "description": "4-digit Belgian postal code matching the location. Used to scope 2dehands (which needs a postcode + radius) and to resolve the region (Flanders/Wallonia/Brussels) for the renovation-urgency flag."
                    },
                    "epcGrades": {
                        "title": "EPC grades to keep",
                        "type": "array",
                        "description": "Which EPC grades count as distress. Default E, F and G (the energy sieves under renovation-obligation pressure). Grade G does not occur in Flanders (its scale tops out at F).",
                        "items": {
                            "type": "string",
                            "enum": [
                                "A+",
                                "A",
                                "B",
                                "C",
                                "D",
                                "E",
                                "F",
                                "G"
                            ],
                            "enumTitles": [
                                "A+",
                                "A",
                                "B",
                                "C",
                                "D",
                                "E (obligation trigger)",
                                "F (obligation trigger)",
                                "G (Wallonia/Brussels only)"
                            ]
                        },
                        "default": [
                            "E",
                            "F",
                            "G"
                        ]
                    },
                    "transactionType": {
                        "title": "Transaction",
                        "enum": [
                            "sale",
                            "rent"
                        ],
                        "type": "string",
                        "description": "Sale (verkoop) or rent (verhuur).",
                        "default": "sale"
                    },
                    "propertyType": {
                        "title": "Property type (optional)",
                        "enum": [
                            "",
                            "apartment",
                            "house",
                            "land",
                            "parking",
                            "commercial",
                            "room"
                        ],
                        "type": "string",
                        "description": "Restrict to one property type. Leave empty for all types.",
                        "default": ""
                    },
                    "portals": {
                        "title": "Portals",
                        "type": "array",
                        "description": "Which Belgian portals to run and deduplicate across. Only Immoweb and Zimmo expose an EPC field — 2dehands and Immovlan still contribute to cross-portal dedup and the FSBO signal, but never carry an EPC grade themselves.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "immoweb",
                                "2dehands",
                                "immovlan",
                                "zimmo"
                            ],
                            "enumTitles": [
                                "Immoweb",
                                "2dehands",
                                "Immovlan",
                                "Zimmo"
                            ]
                        },
                        "default": [
                            "immoweb",
                            "2dehands",
                            "immovlan",
                            "zimmo"
                        ]
                    },
                    "sellerFilter": {
                        "title": "Seller filter",
                        "enum": [
                            "all",
                            "fsbo_only",
                            "agency_only"
                        ],
                        "type": "string",
                        "description": "Return all distress listings, only FSBO (private-owner) ones, or only agency-listed. A private owner of an E/F/G property is the premium lead, but agency-listed distress properties are still valid renovation-lead-gen targets.",
                        "default": "all"
                    },
                    "onlyNew": {
                        "title": "Only new listings since last run",
                        "type": "boolean",
                        "description": "Return only distress properties not seen in a previous run. Backed by a per-account key-value store. Leave off for a full snapshot.",
                        "default": false
                    },
                    "enrichAgencies": {
                        "title": "Enrich agencies via KBO/BCE",
                        "type": "boolean",
                        "description": "Cross-reference agency-listed properties against the Belgian KBO/BCE company registry to attach agency phone and enterprise number. Adds extra lookups, so runs take longer. Off by default.",
                        "default": false
                    },
                    "minPrice": {
                        "title": "Min price (EUR)",
                        "type": "integer",
                        "description": "Lower price bound passed to the portals that support it. Leave empty for no minimum."
                    },
                    "maxPrice": {
                        "title": "Max price (EUR)",
                        "type": "integer",
                        "description": "Upper price bound passed to the portals that support it. Leave empty for no maximum."
                    },
                    "maxItemsPerSource": {
                        "title": "Max items per portal",
                        "type": "integer",
                        "description": "Cap on listings pulled from each portal before the EPC filter and dedup. Raise it in areas with fewer E/F/G listings. Immoweb and Zimmo fetch one detail page per item (~10s each), so a high value needs a matching per-portal timeout.",
                        "default": 30
                    },
                    "timeoutPerSourceSecs": {
                        "title": "Per-portal timeout (seconds)",
                        "type": "integer",
                        "description": "How long to wait for each portal run before treating it as failed. Immoweb/Zimmo detail-page fetches take ~10s per item — keep this above maxItemsPerSource x 10s or those two EPC sources will time out and get excluded.",
                        "default": 240
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Passed through to the child portal scrapers. Belgian residential proxy is strongly recommended — Immoweb and Zimmo are anti-bot-protected and return 403s on datacenter IPs.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "BE"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
