# Pararius.nl Scraper — Dutch Real Estate (`unfenced-group/pararius-scraper`) Actor Scrape rental and sale property listings from Pararius.nl — the Netherlands' leading expat property portal. Extracts price, address, surface, rooms, energy label, agency, and 40+ fields per listing. No proxy required. - **URL**: https://apify.com/unfenced-group/pararius-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Pararius.nl Scraper ![pararius-scraper](https://api.apify.com/v2/key-value-stores/lJlifu6C8YQfZMPKE/records/pararius-scraper) Extract structured rental and sale property listings from **Pararius.nl** — the Netherlands' leading expat and international property portal with 60,000+ verified listings from professional real estate agents. No API key, login, or proxy required. --- ### Features - **Sale & Rental** — scrape both `koopwoningen` and `huurwoningen` - **City-based search** — target Amsterdam, Rotterdam, The Hague, Utrecht, and any other Dutch city - **All property types** — apartments, houses, studios, rooms, and more - **Listing label detection** — identifies Nieuw (new) and Uitgelicht (featured) listings - **Agency extraction** — agency name and profile URL per listing - **Clean structured output** — 40+ fields per listing including address, geo, price, specs, photos - **Detail page enrichment** — optional deep scrape for full specs via `fetchDetails` - **Start URLs support** — paste any Pararius search URL directly --- ### Architecture **JSON-HTML** — HTTP-only via `got-scraping` + Cheerio. Pararius is a server-side-rendered PHP (Symfony) application with no accessible REST or GraphQL API for listings. The map view uses Mapbox Vector Tiles (binary MVT), not JSON. Rich structured data is extracted from: 1. **Search pages** — precise CSS selectors on listing cards (UUID, URL, title, price, surface, label, thumbnail) 2. **Detail pages** — `application/ld+json` (House/Product schema with address, geo, price, rooms) + DT/DD kenmerken table (30+ property specs) + agent summary section --- ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `transaction` | Select | `huurwoningen` | `huurwoningen` (rent) or `koopwoningen` (sale) | | `cities` | Array | `["amsterdam"]` | Dutch city slugs, e.g. `["amsterdam","rotterdam","den-haag"]` | | `propertyType` | Select | `` (all) | `appartement`, `huis`, `studio`, or `kamer` | | `maxItems` | Integer | `100` | Maximum listings to return | | `fetchDetails` | Boolean | `false` | Fetch each listing detail page for full specs, geo, agency, description | | `startUrls` | Array | `[]` | Direct Pararius search or listing page URLs | --- ### Output #### Always present (search card) | Field | Type | Description | |-------|------|-------------| | `listingId` | String | Pararius UUID (e.g. `1357a9d9-ab7e-5d13-8052-94c1d876d1bd`) | | `url` | String | Listing page URL | | `transaction` | String | `huurwoningen` or `koopwoningen` | | `listingLabel` | String\|null | `Nieuw`, `Uitgelicht`, or null | | `title` | String | Listing title (e.g. `Appartement Jan Evertsenstraat`) | | `priceRaw` | String | Price as displayed (e.g. `€ 2.500 per maand`) | | `priceMonthly` | Integer\|null | Monthly rent in EUR (rent listings only) | | `purchasePrice` | Integer\|null | Purchase price in EUR (sale listings only) | | `priceCurrency` | String | Always `EUR` | | `city` | String | City name | | `postalCode` | String | Postal code, no space (e.g. `1061XZ`) | | `neighbourhood` | String\|null | Neighbourhood/district name | | `surface` | Integer\|null | Living area in m² | | `rooms` | Integer\|null | Number of rooms | | `thumbnail` | String\|null | Card thumbnail image URL (without CDN params) | | `images` | Array | Photo URLs (thumbnail only if fetchDetails=false) | | `source` | String | Always `pararius.nl` | | `scrapedAt` | String | ISO 8601 timestamp | | `contentHash` | String | MD5 of UUID+price+surface for deduplication | #### Detail fields (require `fetchDetails: true`) | Field | Type | Description | |-------|------|-------------| | `streetAddress` | String | Street name and number | | `addressLocality` | String | City (from JSON-LD) | | `addressRegion` | String | Neighbourhood/district (from JSON-LD) | | `latitude` | Number | WGS84 latitude | | `longitude` | Number | WGS84 longitude | | `bedrooms` | Integer | Number of bedrooms | | `bathrooms` | Integer | Number of bathrooms | | `volume` | Integer | Volume in m³ | | `floorCount` | Integer | Number of levels in the property | | `constructionYear` | Integer | Year built | | `floor` | Integer | Floor level | | `pricePerSqm` | Integer | Price per m² in EUR | | `deposit` | Integer | Security deposit in EUR | | `listedDate` | String | Date listed (ISO YYYY-MM-DD) | | `publishDate` | String | Offer validFrom date (ISO YYYY-MM-DD) | | `availableFrom` | String | Availability (e.g. `Per direct`, `Per 01-07-2026`) | | `contractType` | String | `Onbepaalde tijd`, `Bepaalde tijd`, etc. | | `rentalPeriod` | String | Rental period description | | `interior` | String | `Gestoffeerd`, `Gemeubileerd`, `Kaal` | | `condition` | String | Maintenance condition | | `status` | String | Listing status (e.g. `Te huur`) | | `propertyTypeDetail` | String | Property type (e.g. `Appartement`, `Woonhuis`) | | `buildingType` | String | Building subtype (e.g. `Bovenwoning`) | | `constructionType` | String | `Bestaande bouw` or `Nieuwbouw` | | `locationSituation` | String | Location description (e.g. `In het centrum`, `Aan het water`) | | `heatingType` | String | Heating system (e.g. `Stadsverwarming`, `CV-ketel`) | | `balcony` | Boolean | Has balcony | | `roofTerrace` | Boolean | Has roof terrace | | `garden` | Boolean | Has garden | | `storage` | Boolean | Has shed/storage | | `amenities` | String | Comma-separated amenities (e.g. `Toilet Lift Bad Douche`) | | `energyLabel` | String | Energy label (A++ to G) | | `description` | String | Listing description in Markdown | | `mainImage` | String | Primary listing image URL | | `agencyName` | String | Real estate agency name | | `agencyUrl` | String | Agency profile URL on Pararius | --- ### 💰 Pricing **$1.50 per 1,000 results** — you only pay for successfully retrieved listings. | Results | fetchDetails=false | fetchDetails=true | |---------|--------------------|-------------------| | 100 | ~$0.15 | ~$0.30 | | 1,000 | ~$1.50 | ~$3.00 | | 10,000 | ~$15.00 | ~$30.00 | --- ### Example use cases **Rental apartments in Amsterdam under €2,000/month:** Set `transaction: huurwoningen`, `cities: ["amsterdam"]`, then post-filter on `priceMonthly`. **Market research across major cities:** Set `cities: ["amsterdam","rotterdam","den-haag","utrecht","eindhoven"]` for a nationwide overview. **Agency portfolio research:** Enable `fetchDetails: true` to get `agencyName` and `agencyUrl` per listing. **New listings only:** Filter results where `listingLabel === "Nieuw"` after scraping. --- ### Examples **Rental apartments in Amsterdam** ```json { "transaction": "rent", "propertyType": "apartment", "cities": ["Amsterdam"], "maxItems": 100 } ```` **Rentals in Rotterdam under €1,500/month** ```json { "transaction": "rent", "cities": ["Rotterdam"], "maxPrice": 1500, "maxItems": 50 } ``` **Houses for sale in Utrecht** ```json { "transaction": "sale", "propertyType": "house", "cities": ["Utrecht"], "maxItems": 100 } ``` **New listings — last 7 days** ```json { "transaction": "rent", "cities": ["Amsterdam"], "daysOld": 7, "maxItems": 200 } ``` *** ### Need a custom scraper? **[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free. If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio. **Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl) # Actor input Schema ## `transaction` (type: `string`): Listing type ## `propertyType` (type: `string`): Filter by property type. ## `minPrice` (type: `integer`): Minimum listing price (local currency). Leave empty for no minimum. ## `maxPrice` (type: `integer`): Maximum listing price (local currency). Leave empty for no maximum. ## `daysOld` (type: `integer`): Only return listings published within the last N days. Leave empty for no recency filter. ## `fetchDetails` (type: `boolean`): Fetch each listing detail page for full data: agency, geo, all specs, description. Slower but richer output. ## `maxItems` (type: `integer`): Maximum number of listings to return. ## `startUrls` (type: `array`): Optional: Pararius.nl search or listing page URLs to scrape directly. ## `cities` (type: `array`): Dutch city slugs, e.g. \["amsterdam","rotterdam","den-haag"]. Use \["nederland"] for nationwide. ## Actor input object example ```json { "transaction": "rent", "propertyType": "", "maxItems": 100, "startUrls": [], "cities": [ "amsterdam" ] } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/pararius-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 100 } # Run the Actor and wait for it to finish run = client.actor("unfenced-group/pararius-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 '{ "maxItems": 100 }' | apify call unfenced-group/pararius-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/pararius-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pararius.nl Scraper — Dutch Real Estate", "description": "Scrape rental and sale property listings from Pararius.nl — the Netherlands' leading expat property portal. Extracts price, address, surface, rooms, energy label, agency, and 40+ fields per listing. No proxy required.", "version": "0.0", "x-build-id": "bDrHHc9baHtaNibC2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~pararius-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-pararius-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/unfenced-group~pararius-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-pararius-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/unfenced-group~pararius-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-pararius-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": { "transaction": { "title": "Transaction type", "enum": [ "rent", "sale" ], "type": "string", "description": "Listing type", "default": "rent" }, "propertyType": { "title": "Property type", "enum": [ "", "appartement", "huis", "studio", "kamer" ], "type": "string", "description": "Filter by property type.", "default": "" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum listing price (local currency). Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum listing price (local currency). Leave empty for no maximum." }, "daysOld": { "title": "Max listing age (days)", "minimum": 0, "type": "integer", "description": "Only return listings published within the last N days. Leave empty for no recency filter." }, "fetchDetails": { "title": "Fetch listing details", "type": "boolean", "description": "Fetch each listing detail page for full data: agency, geo, all specs, description. Slower but richer output." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of listings to return.", "default": 100 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional: Pararius.nl search or listing page URLs to scrape directly.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "cities": { "title": "Cities", "type": "array", "description": "Dutch city slugs, e.g. [\"amsterdam\",\"rotterdam\",\"den-haag\"]. Use [\"nederland\"] for nationwide.", "default": [ "amsterdam" ], "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```