# Zimmo Property Search Scraper (`stealth_mode/zimmo-property-search-scraper`) Actor

Scrape property listings from Zimmo.be search results with ease. Collect prices, locations, energy labels, advertiser info, and 40+ fields per listing — perfect for real estate analysts, investors, and market researchers in Belgium.

- **URL**: https://apify.com/stealth\_mode/zimmo-property-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## Zimmo.be Property Search Scraper: Extract Belgian Real Estate Listings
---

### What Is Zimmo.be?

Zimmo.be is one of Belgium's leading real estate platforms, aggregating thousands of property listings for sale and takeover across Flemish, Walloon, and Brussels regions. The platform hosts listings from both private sellers and professional agencies, covering apartments, houses, land, and commercial properties.

Manually collecting listing data from Zimmo search results is tedious and unscalable. The **Zimmo.be Property Search Scraper** automates extraction from paginated search result pages, delivering structured records ready for analysis or integration.

---

### Overview

The **Zimmo.be Scraper** targets property search result pages and extracts detailed listing data into clean, structured records. It is suited for:

- **Real estate investors** monitoring market prices by municipality
- **Data analysts** tracking supply trends, price drops, and energy performance
- **Proptech developers** feeding aggregator platforms or valuation models
- **Researchers** studying the Belgian housing market

The scraper handles paginated search URLs, respects configurable item limits, and can skip failed URLs to keep bulk runs uninterrupted.

---

### Input Format

```json
{
  "urls": [
    "https://www.zimmo.be/fr/rechercher/?search=eyJmaWx0ZXIi...&p=2#gallery"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}
````

| Field | Type | Description |
|---|---|---|
| `urls` | `array` | One or more Zimmo.be property search result page URLs. Add pages individually or use bulk edit. Supports paginated URLs (e.g., `&p=2`). |
| `max_items_per_url` | `integer` | Maximum listings to collect per URL. Default: `20`. Increase up to `50`+ for denser result pages. |
| `ignore_url_failures` | `boolean` | If `true`, the scraper continues when a URL fails instead of stopping the entire run. Recommended for bulk jobs. |

> **Tip:** Zimmo encodes search filters (location, status, type) in a base64 parameter within the URL. Build your search on Zimmo.be, copy the full URL including the `search=` parameter and page number, then paste it into `urls`.

***

### Output Format

**Sample output**

```json
{
  "particulier_pand_id": null,
  "code": "LLVNA",
  "uuid": "cf0e8af1-d63c-4ac9-9560-7452df7ec789",
  "type": "Bien professionnel",
  "type_id": "4",
  "status": "general.status.for_sale",
  "status_id": "1",
  "hoofd_foto": "https://files.zimmo.be/backend-api/_mCkuCoNl_1fZ3vzTuxdbSO_4JM=/828x618/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/dealers/c682fd5d-b3b3-43cd-9db9-1f88d5944599/listings/cf0e8af1-d63c-4ac9-9560-7452df7ec789/images/019cd76f-d93e-726b-9542-8cf667025d97",
  "b_woonopp": "325",
  "toegevoegd": "1773140956",
  "slaapkamers": "0",
  "nieuwbouw": "1",
  "prijs": "520000",
  "zprijs": null,
  "address": "Industriepark 22",
  "gemeente": "Heist-op-den-Berg",
  "postcode": "2220",
  "lat": "51.083779000",
  "lon": "4.808583000",
  "parcel_id": null,
  "logo": "https://files.zimmo.be/backend-api/x12STQmtgb4wwt-IHHtL9s3TDOw=/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/logos/01995d00-92f6-7412-b6ea-6258f0d09b91",
  "proj_id": "0",
  "advertiser": {
    "name": "PANORAMA B2B Limburg",
    "phone": "+3211220300",
    "mobile": "+3211220300",
    "show_email": 1,
    "office_type": null,
    "use_zimmo_detail": false,
    "picture_zoom_percentage": null,
    "picture_logo_position": null,
    "picture_apply_main_only": null,
    "officebox": true,
    "officebox_url": "https://www.zimmo.be/fr/agence-immobiliere/hasselt-3500/panorama-b2b-limburg-94015/",
    "name_prefix": "",
    "logo": "https://files.zimmo.be/backend-api/x12STQmtgb4wwt-IHHtL9s3TDOw=/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/logos/01995d00-92f6-7412-b6ea-6258f0d09b91",
    "website": "www.panoramab2b.be",
    "postal_code": "3500",
    "city": "Hasselt",
    "address": "Hendrik van Veldekesingel  150",
    "for_rent": null,
    "for_sale": null,
    "officebox_tekoop": "https://www.zimmo.be/fr/agence-immobiliere/hasselt-3500/panorama-b2b-limburg-94015/a-vendre/",
    "officebox_tehuur": "https://www.zimmo.be/fr/agence-immobiliere/hasselt-3500/panorama-b2b-limburg-94015/a-louer/"
  },
  "favoriet": false,
  "archief": "0",
  "a_beschrijf": "",
  "foto_amount": 6,
  "is_promoted": true,
  "subtype_naam": "Bâtiment d’entreprise",
  "sticker": "",
  "price_drop_date": "",
  "zimmo_kantoor_id": "23381",
  "plus": "0",
  "energy_waarde": "",
  "energy_label": "",
  "energy_label_category": "",
  "html": "",
  "property_item_logo": "https://files.zimmo.be/backend-api/x12STQmtgb4wwt-IHHtL9s3TDOw=/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/logos/01995d00-92f6-7412-b6ea-6258f0d09b91",
  "province": "Anvers",
  "is_published": false,
  "url": "/fr/heist-op-den-berg-2220/a-vendre/bien-professionnel/LLVNA/",
  "first_images": [
    "https://files.zimmo.be/backend-api/_mCkuCoNl_1fZ3vzTuxdbSO_4JM=/828x618/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/dealers/c682fd5d-b3b3-43cd-9db9-1f88d5944599/listings/cf0e8af1-d63c-4ac9-9560-7452df7ec789/images/019cd76f-d93e-726b-9542-8cf667025d97",
    "https://files.zimmo.be/backend-api/61JniUB5ThpNuxBK9l1CzpB8R1g=/828x618/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/dealers/c682fd5d-b3b3-43cd-9db9-1f88d5944599/listings/cf0e8af1-d63c-4ac9-9560-7452df7ec789/images/019cd76f-dce8-7a8b-95e3-9a681c1b3723",
    "https://files.zimmo.be/backend-api/AN-acLdxiuvvXvGUgeciwayVHFA=/828x618/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/dealers/c682fd5d-b3b3-43cd-9db9-1f88d5944599/listings/cf0e8af1-d63c-4ac9-9560-7452df7ec789/images/019cd76f-e0b9-7b8c-945a-955f224fc230",
    "https://files.zimmo.be/backend-api/0mS0tn4A3nAcuXbLcf6DD1l9yTc=/828x618/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/dealers/c682fd5d-b3b3-43cd-9db9-1f88d5944599/listings/cf0e8af1-d63c-4ac9-9560-7452df7ec789/images/019cd76f-e1c9-7074-9ab0-a1721e806974",
    "https://files.zimmo.be/backend-api/jS8jYrZCAcuGkEZ4l9i9Ap5OgOQ=/828x618/filters:image-format(pjpg)/-/real-estate/customers/b51c1823-4bae-11e9-922b-005056b768a1/dealers/c682fd5d-b3b3-43cd-9db9-1f88d5944599/listings/cf0e8af1-d63c-4ac9-9560-7452df7ec789/images/019cd76f-e541-79e8-9a31-75aba2fe6dd9"
  ],
  "pand_url": "/fr/heist-op-den-berg-2220/a-vendre/bien-professionnel/LLVNA/",
  "id": "LLVNA"
}
```

Each listing returns a record with 43 fields across identification, pricing, location, media, and metadata categories.

#### Identification

| Field | Meaning |
|---|---|
| `ID` | Internal scraper-assigned record ID |
| `Particulier Pand ID` | Zimmo's private listing identifier |
| `Code` | Short property code used in Zimmo's system |
| `UUID` | Universally unique identifier for the listing |
| `Parcel ID` | Cadastral parcel reference, where available |
| `Proj ID` | Project ID for new development listings |
| `Zimmo Kantoor ID` | ID of the Zimmo office managing the listing |

#### Type & Status

| Field | Meaning |
|---|---|
| `Type` | Property type label (e.g., House, Apartment) |
| `Type ID` | Numeric code for the property type |
| `Subtype Naam` | More specific subtype name (e.g., Villa, Studio) |
| `Status` | Listing status label (e.g., `FOR_SALE`, `TAKE_OVER`) |
| `Status ID` | Numeric code for the listing status |
| `Nieuwbouw` | Boolean flag indicating new construction |
| `Is Published` | Whether the listing is currently live |
| `Is Promoted` | Whether the listing has paid promotion |
| `Plus` | Indicates a Zimmo Plus featured placement |
| `Sticker` | Promotional sticker label shown on the listing |

#### Pricing

| Field | Meaning |
|---|---|
| `Prijs` | Displayed listing price |
| `Zprijs` | Zimmo-normalized or estimated price value |
| `Price Drop Date` | Date of the most recent price reduction, if any |

#### Location

| Field | Meaning |
|---|---|
| `Address` | Full address string |
| `Gemeente` | Municipality (commune) name |
| `Postcode` | Belgian postal code |
| `Province` | Province the property is located in |
| `Lat` | Latitude coordinate |
| `Lon` | Longitude coordinate |

#### Property Details

| Field | Meaning |
|---|---|
| `B Woonopp` | Living area in square meters |
| `Slaapkamers` | Number of bedrooms |
| `A Beschrijf` | Short property description/summary |
| `HTML` | Full HTML content of the listing detail block |
| `Toegevoegd` | Date the listing was added to Zimmo |

#### Energy

| Field | Meaning |
|---|---|
| `Energy Waarde` | Numeric energy performance value (kWh/m²/year) |
| `Energy Label` | Energy certificate label (e.g., A, B, C) |
| `Energy Label Category` | Grouped category for the energy label |

#### Media

| Field | Meaning |
|---|---|
| `Hoofd Foto` | URL of the main/hero listing photo |
| `First Images` | Array of the first available listing images |
| `Foto Amount` | Total number of photos attached to the listing |
| `Logo` | Agency or advertiser logo URL |
| `Property Item Logo` | Logo displayed on the listing card in search results |

#### Advertiser & Links

| Field | Meaning |
|---|---|
| `Advertiser` | Name and details of the listing agency or private seller |
| `URL` | Canonical listing URL |
| `Pand URL` | Direct Zimmo property detail page URL |

#### User Flags

| Field | Meaning |
|---|---|
| `Favoriet` | Whether the listing is marked as a favourite (user-specific) |
| `Archief` | Whether the listing is archived |

***

### How to Use

1. **Build your search on Zimmo.be** — Apply filters (location, status, price range, type) and copy the full URL from your browser, including the `search=` encoded parameter.
2. **Set pagination** — To collect multiple pages, add each paginated URL separately (e.g., `&p=1`, `&p=2`).
3. **Configure input** — Paste URLs into `urls`, set `max_items_per_url` (up to 50 per page is typical), and enable `ignore_url_failures` for bulk runs.
4. **Run and export** — Download results as JSON, CSV, or Excel for use in Excel, Power BI, Python, or your database.

**Common issues:**

- If results are empty, confirm the URL is a *search results* page (contains `rechercher` or `zoeken`), not a single listing page.
- Encoded `search=` parameters expire or change when filters are modified — always re-copy the URL after adjusting filters.

***

### Use Cases & Business Value

- **Market analysis:** Track average asking prices by municipality or postal code over time
- **Investment screening:** Filter listings by energy label, size, and price drop history
- **Portfolio monitoring:** Watch competitor agency listings across regions
- **Valuation models:** Feed raw listing data into automated valuation or regression models

The scraper eliminates hours of manual copy-paste work, delivering consistent structured data that integrates directly into your analytics pipeline.

***

### Conclusion

The **Zimmo.be Property Search Scraper** is an efficient tool for anyone needing Belgian real estate data at scale. With 43 output fields covering pricing, location, energy performance, media, and advertiser details, it provides the depth required for serious market research or investment analysis. Configure your search, run the scraper, and start working with clean property data immediately.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.zimmo.be/fr/rechercher/?search=eyJmaWx0ZXIiOnsic3RhdHVzIjp7ImluIjpbIkZPUl9TQUxFIiwiVEFLRV9PVkVSIl19LCJwbGFjZUlkIjp7ImluIjpbNzE0XX0sInppbW1vQ29kZSI6eyJub3RJbiI6WyJMSFNVNiIsIkxJN0Q0Il19fSwicGFnaW5nIjp7ImZyb20iOjAsInNpemUiOjE5fSwic29ydGluZyI6W3sidHlwZSI6IlJBTktJTkdfU0NPUkUiLCJvcmRlciI6IkRFU0MifV19&p=2#gallery"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 = {
    "urls": [
        "https://www.zimmo.be/fr/rechercher/?search=eyJmaWx0ZXIiOnsic3RhdHVzIjp7ImluIjpbIkZPUl9TQUxFIiwiVEFLRV9PVkVSIl19LCJwbGFjZUlkIjp7ImluIjpbNzE0XX0sInppbW1vQ29kZSI6eyJub3RJbiI6WyJMSFNVNiIsIkxJN0Q0Il19fSwicGFnaW5nIjp7ImZyb20iOjAsInNpemUiOjE5fSwic29ydGluZyI6W3sidHlwZSI6IlJBTktJTkdfU0NPUkUiLCJvcmRlciI6IkRFU0MifV19&p=2#gallery"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/zimmo-property-search-scraper").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 = {
    "urls": ["https://www.zimmo.be/fr/rechercher/?search=eyJmaWx0ZXIiOnsic3RhdHVzIjp7ImluIjpbIkZPUl9TQUxFIiwiVEFLRV9PVkVSIl19LCJwbGFjZUlkIjp7ImluIjpbNzE0XX0sInppbW1vQ29kZSI6eyJub3RJbiI6WyJMSFNVNiIsIkxJN0Q0Il19fSwicGFnaW5nIjp7ImZyb20iOjAsInNpemUiOjE5fSwic29ydGluZyI6W3sidHlwZSI6IlJBTktJTkdfU0NPUkUiLCJvcmRlciI6IkRFU0MifV19&p=2#gallery"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/zimmo-property-search-scraper").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 '{
  "urls": [
    "https://www.zimmo.be/fr/rechercher/?search=eyJmaWx0ZXIiOnsic3RhdHVzIjp7ImluIjpbIkZPUl9TQUxFIiwiVEFLRV9PVkVSIl19LCJwbGFjZUlkIjp7ImluIjpbNzE0XX0sInppbW1vQ29kZSI6eyJub3RJbiI6WyJMSFNVNiIsIkxJN0Q0Il19fSwicGFnaW5nIjp7ImZyb20iOjAsInNpemUiOjE5fSwic29ydGluZyI6W3sidHlwZSI6IlJBTktJTkdfU0NPUkUiLCJvcmRlciI6IkRFU0MifV19&p=2#gallery"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call stealth_mode/zimmo-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/zimmo-property-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zimmo Property Search Scraper",
        "description": "Scrape property listings from Zimmo.be search results with ease. Collect prices, locations, energy labels, advertiser info, and 40+ fields per listing — perfect for real estate analysts, investors, and market researchers in Belgium.",
        "version": "0.0",
        "x-build-id": "aAnowCo2CsroT9Rvn"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~zimmo-property-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-zimmo-property-search-scraper",
                "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/stealth_mode~zimmo-property-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-zimmo-property-search-scraper",
                "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/stealth_mode~zimmo-property-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-zimmo-property-search-scraper",
                "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",
                "properties": {
                    "urls": {
                        "title": "URLs of the property list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your scraper."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
