{ "openapi": "3.0.1", "info": { "title": "Funda.nl | 💰$0.7 per 1,000 results | Fast, broad results", "description": "$0.7 per 1000 results. Scrape Funda.nl property listings - Extract prices, photos, agent details, energy labels & more. Supports search URLs, unlimited results via price-range splitting, and raw API output. Perfect for Dutch real estate\n analysis and market research.", "version": "1.0", "x-build-id": "eS39WuiGWfAhW0QUF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~funda-nl-just-0-7-per-1000-fast-broad-results/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-funda-nl-just-0-7-per-1000-fast-broad-results", "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/solidcode~funda-nl-just-0-7-per-1000-fast-broad-results/runs": { "post": { "operationId": "runs-sync-solidcode-funda-nl-just-0-7-per-1000-fast-broad-results", "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/solidcode~funda-nl-just-0-7-per-1000-fast-broad-results/run-sync": { "post": { "operationId": "run-sync-solidcode-funda-nl-just-0-7-per-1000-fast-broad-results", "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": { "searchUrls": { "title": "Funda Search URLs", "type": "array", "description": "Paste one or more Funda.nl search result URLs. The actor reads the filters from each URL automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "offeringType": { "title": "Offering Type", "enum": [ "buy", "rent" ], "type": "string", "description": "Choose whether to scrape homes for sale or for rent.", "default": "buy" }, "availability": { "title": "Availability", "enum": [ "available", "unavailable", "negotiations" ], "type": "string", "description": "Choose which listing status to include.", "default": "available" }, "propertyTypes": { "title": "Property Types", "type": "array", "description": "Choose one or more property types to include.", "items": { "type": "string", "enum": [ "single", "apartment", "parking", "land" ], "enumTitles": [ "House", "Apartment", "Parking", "Land" ] }, "default": [ "single" ] }, "location": { "title": "Location", "type": "string", "description": "Enter a city, neighbourhood, postal code, or address." }, "priceFrom": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Only include listings at or above this price in euros." }, "priceTo": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Only include listings at or below this price in euros." }, "sortBy": { "title": "Sort By", "enum": [ "publish_date_utc", "price", "floor_area", "plot_area" ], "type": "string", "description": "Choose how Funda orders the results.", "default": "publish_date_utc" }, "sortOrder": { "title": "Sort Order", "enum": [ "asc", "desc" ], "type": "string", "description": "Choose ascending or descending order.", "default": "desc" }, "maxItems": { "title": "Maximum Items", "minimum": 0, "type": "integer", "description": "Set how many listings to collect. Use 0 to collect as many as possible, up to the built-in safety cap.", "default": 100 }, "outputFormat": { "title": "Output Format", "enum": [ "clean", "raw" ], "type": "string", "description": "Choose simple cleaned output or the original listing response.", "default": "clean" }, "outputFields": { "title": "Output Fields", "type": "array", "description": "Choose which fields to keep in clean output. Leave empty to keep all clean fields.", "items": { "type": "string", "enum": [ "fundaId", "url", "status", "street", "houseNumber", "houseNumberSuffix", "postalCode", "city", "province", "neighbourhood", "wijk", "sellingPrice", "sellingPriceType", "sellingPriceCondition", "originalSellingPrice", "objectType", "offeringType", "floorArea", "plotArea", "floorAreaRange", "plotAreaRange", "numberOfRooms", "numberOfBedrooms", "energyLabel", "publishDate", "photoUrls", "thumbnailUrl", "availableMediaTypes", "agent" ], "enumTitles": [ "Funda ID", "Listing URL", "Status", "Street", "House number", "House number suffix", "Postal code", "City", "Province", "Neighbourhood", "District", "Selling price", "Price type", "Price condition", "Original selling price", "Property type", "Offering type", "Floor area", "Plot area", "Floor area range", "Plot area range", "Number of rooms", "Number of bedrooms", "Energy label", "Publish date", "Photo URLs", "Thumbnail URL", "Available media types", "Agent" ] } }, "delayBetweenRequests": { "title": "Delay Between Requests", "minimum": 0.1, "maximum": 5, "type": "number", "description": "Base pause between requests in seconds. The actor adds small random variation automatically.", "default": 0.3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Set proxy options to reduce rate limits and blocks during larger runs." } } }, "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 } } } } } } } } } }