{ "openapi": "3.0.1", "info": { "title": "Funda Scraper: Netherlands Property Listings", "description": "Scrape funda.nl property listings: homes for sale and for rent by area, with price, address, living area, rooms, energy label, agency and photos. Filter by property type and price. Optional coordinates, description and features. Export JSON, CSV or Excel. Unofficial.", "version": "0.1", "x-build-id": "Do83jqXmmKj6bfyUi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~funda-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-funda-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/reventadata~funda-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-funda-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/reventadata~funda-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-funda-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": { "offering": { "title": "Buy or rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Homes for sale (funda /zoeken/koop) or for rent (funda /zoeken/huur).", "default": "sale" }, "areas": { "title": "Areas", "type": "array", "description": "Funda area slugs, one search per area, as they appear in selected_area of a funda.nl search URL, for example \"amsterdam\" or \"utrecht\". Leave empty to search the whole Netherlands (more than 100,000 homes; funda serves at most 9,990 results per search, so add a price range or object type). An unknown slug returns no results.", "items": { "type": "string" } }, "objectType": { "title": "Property type", "enum": [ "", "house", "apartment" ], "type": "string", "description": "Only houses or only apartments. Leave empty for every type (the site also lists parking spaces, storage and plots).", "default": "" }, "sort": { "title": "Sort order", "enum": [ "relevance", "newest" ], "type": "string", "description": "Funda's default relevance order, or newest listings first.", "default": "relevance" }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Sent to funda as the price range, together with the minimum price when one is set. On a rent search this is the monthly rent." }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Rows below this price, or with no price, are dropped. Funda is asked for the range only when a maximum price is set too, so on its own this filter is applied after fetching and does not reduce the number of pages fetched." }, "minLivingAreaM2": { "title": "Minimum living area (m²)", "minimum": 0, "type": "integer", "description": "Optional. Rows with a smaller living area, or none, are dropped after fetching." }, "maxLivingAreaM2": { "title": "Maximum living area (m²)", "minimum": 0, "type": "integer", "description": "Optional. Rows with a larger living area, or none, are dropped after fetching." }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Optional. Rows with fewer bedrooms, or no bedroom count, are dropped after fetching." }, "includeDetails": { "title": "Include coordinates, description and features", "type": "boolean", "description": "Open each listing's own page for latitude, longitude, the full description and the feature table. This is one extra unblocking request per row, so a run takes about as many extra requests as it has rows and is much slower. Each detail page used in a returned row is charged as a separate pay-per-event \"detail-page\" event (see the Store page for pricing); a detail page that cannot be read is not charged.", "default": false }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on rows pushed across all areas.", "default": 100 }, "maxPages": { "title": "Maximum pages per area", "minimum": 1, "maximum": 666, "type": "integer", "description": "Cap on result pages fetched per area (15 listings each, at most 666 pages). Each page is one paid unblocking request on the Actor's side and takes about 18 to 51 seconds (measured). The run also stops at the last page the site reports.", "default": 5 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }