# Immoweb Listing Scraper

> Immoweb Listing Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured real estate listing data from Immoweb search result pages, returning property details including type, transaction type, descriptions, and energy info.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/immoweb?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/immoweb-listing-scraper-7579e4f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BCj45O_MBTYOhiA1gn3Ma

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability immoweb-listing-scraper-7579e4f5 -d '<json body>'
```

Example prompt: Can you pull up to 50 Immoweb listings for apartments for sale in Ghent from this search URL https://www.immoweb.be/en/search/apartment/for-sale?countries=BE&locality=Ghent and include all the details like descriptions, energy info, and agency?

## When to prefer this

Use this endpoint when you specifically need structured data from Immoweb (the dominant Belgian real estate portal). It is the right choice when you have an Immoweb search URL with filters already applied (location, price, property type, transaction type) and need bulk structured listing data. Prefer it over generic web scrapers when you need Immoweb-specific fields like energy ratings, agency info, and property subtypes parsed cleanly without additional transformation.

## Known failure modes

- Invalid or inaccessible Immoweb search URL returns empty results (not charged)
- Immoweb blocking or rate-limiting causes failed run (not charged)
- maxItems set too high may cause timeout on very large result sets
- URL points to a single listing rather than a search results page, causing empty output
- Non-Immoweb URLs result in failed or empty runs

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of listings found and an array of items, each with fields like id, URL, title, description, property type, property subtype, transaction type, and the originating search URL. When includeDetails is true, additional fields such as energy info, agency details, and publication data are included. The product field confirms 'immoweb'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum unique listings to save. Use 0 for all listings accessible through this search."
  },
  "startUrl": {
   "type": "string",
   "description": "Full public Immoweb search results URL. Apply location, property, price, and transaction filters on the site before copying it."
  },
  "includeDetails": {
   "type": "boolean",
   "default": true,
   "description": "Open each public listing for descriptions, energy, publication, agency, and additional property fields."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "title": null,
    "searchUrl": null,
    "description": null,
    "propertyType": null,
    "propertySubtype": null,
    "transactionType": null
   }
  ],
  "product": "immoweb"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/immoweb-listing-scraper-7579e4f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
