{ "openapi": "3.0.1", "info": { "title": "Funda.nl Scraper — Authorized Residential Listings", "description": "Collect authorized public Funda.nl residential listing data from search or detail URLs. Returns normalized Dutch property fields, run diagnostics, and PPE-ready records.", "version": "0.1", "x-build-id": "T2W0oOLhWzyJbSQgu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~funda-nl-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-funda-nl-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/khadinakbar~funda-nl-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-funda-nl-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/khadinakbar~funda-nl-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-funda-nl-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", "required": [ "confirmAuthorization" ], "properties": { "confirmAuthorization": { "title": "I have permission to collect these Funda URLs", "type": "boolean", "description": "Use this only when you have Funda’s prior written authorization or another valid right to collect the requested public listing data. Funda’s terms prohibit scraping without consent. This Actor does not bypass access controls and will not run until this is true.", "default": false }, "startUrls": { "title": "Funda search or listing URLs", "type": "array", "description": "Use this when you already have authorized Funda residential URLs. Accepts only https://www.funda.nl/zoeken/koop, /zoeken/huur, /detail/koop, or /detail/huur URLs. Example: https://www.funda.nl/zoeken/koop/?selected_area=[%22amsterdam%22]. This is not for fundainbusiness.nl or map URLs.", "items": { "type": "object" } }, "areas": { "title": "Residential areas", "type": "array", "description": "Use this when your authorization covers a named Funda area and you do not have a search URL. Enter town, city, neighbourhood, or postcode names, for example Amsterdam or 3011AA. The Actor creates a basic Funda search; use Start URLs when you need Funda’s own filters.", "items": { "type": "string" } }, "listingType": { "title": "Listing type", "enum": [ "koop", "huur" ], "type": "string", "description": "Use this when generating searches from Residential areas. Choose koop for properties for sale or huur for rental properties. This does not alter an explicit Funda Start URL.", "default": "koop" }, "maxResults": { "title": "Maximum listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this when you need a firm maximum number of returned and billed listings. The actor stops after this many valid detail records. Range 1–500; default 20.", "default": 20 }, "maxPages": { "title": "Maximum search pages per URL or area", "minimum": 1, "maximum": 20, "type": "integer", "description": "Use this when a search can span multiple result pages. It limits discovery before detail pages are requested. Range 1–20; default 2. The Maximum listings cap remains authoritative.", "default": 2 }, "requestDelayMillis": { "title": "Delay between requests (milliseconds)", "minimum": 1000, "maximum": 10000, "type": "integer", "description": "Use this to set a polite delay between Funda requests. Range 1000–10000 milliseconds; default 1500. Lower values are rejected. This is not a rate-limit bypass setting.", "default": 1500 }, "includeDescription": { "title": "Include listing description", "type": "boolean", "description": "Set false when your authorized use only needs structured property fields and you do not need the listing description. Listing photographs and descriptions can be copyright-protected; do not republish them without permission.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use an Apify residential proxy only when your authorization and Funda’s access policy allow it. The default is an NL residential route for stable regional access. The actor does not rotate identities to evade a block or challenge.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "NL" } } } }, "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 } } } } } } } } } }