{ "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": "YuMeKFideiKa7bMFh" }, "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. Copy each address straight out of your browser's address bar so nothing is lost in retyping. If you start runs through the Apify API instead of this form, send each address as {\"url\": \"https://www.funda.nl/...\"}; a plain piece of text on its own is refused before the run can start.", "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. Leave empty to include every property type.", "items": { "type": "string", "enum": [ "single", "apartment", "parking", "land" ], "enumTitles": [ "House", "Apartment", "Parking", "Land" ] } }, "location": { "title": "Location", "type": "string", "description": "Enter a city, neighbourhood, postal code, or address, for example Amsterdam, Jordaan or 1017. A 4-digit postal code covers a whole neighbourhood; a full postal code such as 1017AB covers only a handful of addresses, so it often has no listings at all. Leave this empty to search the whole of the Netherlands." }, "priceFrom": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Only include listings at or above this price in euros. With Offering Type set to Buy this is the asking price; with Rent it is the monthly rent." }, "priceTo": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Only include listings at or below this price in euros. With Offering Type set to Buy this is the asking price; with Rent it is the monthly rent." }, "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", "country", "neighbourhood", "wijk", "sellingPrice", "sellingPriceType", "sellingPriceCondition", "rentPrice", "rentPriceType", "rentPriceCondition", "objectType", "offeringType", "offeringTypes", "floorArea", "plotArea", "numberOfRooms", "numberOfBedrooms", "energyLabel", "publishDate", "photoUrls", "thumbnailUrl", "availableMediaTypes", "agent" ], "enumTitles": [ "Funda ID", "Listing URL", "Status", "Street", "House number", "House number suffix", "Postal code", "City", "Province", "Country", "Neighbourhood", "District", "Selling price", "Price type", "Price condition", "Rent price", "Rent price type", "Rent price period", "Property type", "Offering type", "Offered for (all)", "Floor area", "Plot area", "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 } } } } } } } } } }