{ "openapi": "3.0.1", "info": { "title": "Funda Scraper", "description": "Scrape Funda.nl homes for sale and for rent: price, address, living area, rooms, energy label, agent, photos, listing date, plus full details on request. Works with any Funda search URL.", "version": "0.1", "x-build-id": "HJ35iKDtIbzEbLJus" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~funda-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-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/tortuga~funda-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-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/tortuga~funda-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Funda search result pages to scrape, with any filters and sort applied in the browser, e.g. https://www.funda.nl/zoeken/koop?selected_area=[\"amsterdam\"] or https://www.funda.nl/zoeken/huur?selected_area=[\"utrecht\"]&price=\"1000-2000\". Koop (for sale) and huur (for rent) searches work, including new-build filters (construction_type=[\"newly_built\"]). A single listing URL (…/detail/koop/…/12345678/) is also accepted and returns that one listing with full details. Leave empty if you use Area instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "area": { "title": "Area", "type": "string", "description": "Alternative to Start URLs: a city, municipality, neighbourhood or postcode (4 digits or full), e.g. \"Amsterdam\", \"Den Haag\", \"Utrecht, Amersfoort\", \"1012\", \"nl\" for the whole country. Funda's own area slugs (e.g. \"amsterdam/jordaan\") also work." }, "listingType": { "title": "Listing type", "enum": [ "koop", "huur" ], "type": "string", "description": "Used with Area: homes for sale (koop) or for rent (huur).", "default": "koop" }, "minPrice": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Used with Area. Asking price, or monthly rent for rentals." }, "maxPrice": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Used with Area. Asking price, or monthly rent for rentals." }, "minArea": { "title": "Min living area (m²)", "minimum": 0, "type": "integer", "description": "Used with Area. Minimum living area in square metres." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Used with Area." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Used with Area. Leave empty for all types.", "items": { "type": "string", "enum": [ "house", "apartment", "parking", "land", "storage", "substructure" ], "enumTitles": [ "House (woonhuis)", "Apartment (appartement)", "Parking", "Building plot (bouwgrond)", "Storage (opslagruimte)", "Substructure (onderbouw)" ] }, "default": [] }, "newBuildsOnly": { "title": "New builds only", "type": "boolean", "description": "Used with Area: only newly built homes (nieuwbouw). Note: Funda's new-build *project* pages are rendered client-side and are not covered; individual new-build homes are.", "default": false }, "sort": { "title": "Sort", "enum": [ "", "date_down", "price_up", "price_down", "floor_area_down", "plot_area_down" ], "type": "string", "description": "Used with Area. Funda's default is relevance.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many listings in total (across all start URLs). Keeps cost predictable. Funda shows 15 listings per page and serves at most 666 pages (about 10,000 listings) per search, so split large areas by price band or district to get more.", "default": 100 }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Also open every listing page to get the full description, the complete kenmerken table (construction year, volume, bathrooms, floors, heating, insulation, VvE contribution, ownership/leasehold, deposit and rental terms), coordinates, floor plans, videos, 360° tours, brochure, garden/balcony/parking flags, view and save counts, and the agent office's business phone, website and email. One extra request per listing plus one per distinct agent office; charged extra per listing (see pricing).", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is recommended. Funda sits behind Akamai Bot Manager; datacenter IPs worked in testing but residential is the safer default for larger runs. If you see 403s in the run log, switch to (or keep) the RESIDENTIAL group.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }