{ "openapi": "3.0.1", "info": { "title": "Pararius Scraper – Dutch Rental & Sale Property Data", "description": "Scrape pararius.nl rental and sale listings across the Netherlands: monthly rent, price per m2, deposit, energy label, rooms, agent contacts and full descriptions. Pararius API in JSON/CSV.", "version": "1.0", "x-build-id": "OgbO1ac9qr28SIW4a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~pararius-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-pararius-property-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/sian.agency~pararius-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-pararius-property-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/sian.agency~pararius-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-pararius-property-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": { "operation": { "title": "🎯 What to collect", "enum": [ "search", "detail" ], "type": "string", "description": "One per run. Listing Search walks pararius.nl's result pages and returns a full record per listing straight from the card. Listing Detail opens the listings you list under Listing URLs and adds deposit, contract terms, energy label, room breakdown and the complete advert text.", "default": "search" }, "listingType": { "title": "🤝 Rent or buy", "enum": [ "rent", "sale" ], "type": "string", "description": "Rent reads huurwoningen (the section pararius leads the Dutch market on); sale reads koopwoningen. Applies to Listing Search — Listing Detail follows whatever each URL points at.", "default": "rent" }, "location": { "title": "📍 Place", "type": "string", "description": "A Dutch city, town, province or neighbourhood as pararius writes it in its URLs, e.g. `amsterdam`, `rotterdam`, `utrecht`, `den-haag`, `eindhoven`, `provincie/noord-holland`, `rotterdam/wijk-kralingen-crooswijk`. Plain names are slugified (Den Haag → den-haag). Leave empty only when the place is already inside a pasted search path.", "default": "amsterdam" }, "propertyType": { "title": "🏠 Property type", "enum": [ "any", "appartement", "huis", "studio", "kamer" ], "type": "string", "description": "The portal's own type filter. Room and studio matter for rentals: rooms are a separate segment on pararius with their own price dynamics.", "default": "any" }, "interior": { "title": "🛋️ Interior", "enum": [ "any", "kaal", "gestoffeerd", "gemeubileerd" ], "type": "string", "description": "Rental filter: bare, gestoffeerd (carpets/curtains, the Dutch standard) or fully furnished. Ignored for sales.", "default": "any" }, "minPrice": { "title": "💰 Price from", "type": "integer", "description": "Minimum monthly rent (rentals, euros/month) or asking price (sales, euros). Combined with Price to it builds the portal's own price-band path." }, "maxPrice": { "title": "💰 Price up to", "type": "integer", "description": "Maximum monthly rent (rentals, euros/month) or asking price (sales, euros)." }, "construction": { "title": "🏗️ Build", "enum": [ "any", "bestaande-bouw", "nieuwbouw" ], "type": "string", "description": "Existing stock or new construction.", "default": "any" }, "maxResults": { "title": "📦 Max listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many listings (search) or this many detail rows. One row per listing; duplicates across pages are skipped before the count.", "default": 100 }, "listingUrls": { "title": "🔗 Listing URLs", "type": "array", "description": "For Listing Detail: pararius.nl listing URLs or paths, one object per row, e.g. {\"url\": \"https://www.pararius.nl/appartement-te-huur/amsterdam/8ded0740/herenmarkt\"}. FREE runs read up to 5.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }