{ "openapi": "3.0.1", "info": { "title": "Funda Netherlands Property Listings & Agent Scraper", "description": "Scrape Dutch property listings from across the Netherlands with address, asking price, property type, living and plot area, rooms, bedrooms, energy label, year built, coordinates, photos, description and the listing agent name, contact person, office, phone and email. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "2J03XT7iUaBR44pq4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~funda-netherlands-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-funda-netherlands-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/scrapers_lat~funda-netherlands-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-funda-netherlands-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/scrapers_lat~funda-netherlands-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-funda-netherlands-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": { "maxListings": { "title": "Max Listings To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of property listings to collect across all searches. Optional." }, "withDetails": { "title": "Fetch Full Listing Details", "type": "boolean", "description": "When enabled, each listing is enriched with year built, full description and exact map coordinates from its detail page. Disable for a faster, list-only run.", "default": true }, "withSummary": { "title": "AI listing summary (paid add-on)", "type": "boolean", "description": "Use AI to write a concise English buyer/renter summary of each listing. Billed per successfully summarized listing; paid Apify plans only.", "default": false }, "withFeatures": { "title": "AI feature extraction (paid add-on)", "type": "boolean", "description": "Use AI to extract structured beds/baths/size/amenities/condition tags from each listing. Billed per successfully processed listing; paid Apify plans only.", "default": false }, "withTranslate": { "title": "AI translate description to English (paid add-on)", "type": "boolean", "description": "Use AI to translate each Dutch listing description into English. Billed per successfully translated listing; paid Apify plans only.", "default": false }, "searchQueries": { "title": "Areas / Cities To Search", "type": "array", "description": "One or more Dutch cities, towns or areas to search (for example 'amsterdam', 'utrecht', 'den-haag', 'rotterdam'). One run covers every area in the list.", "items": { "type": "string" } }, "listingType": { "title": "Listing Type", "enum": [ "buy", "rent" ], "type": "string", "description": "Whether to scrape properties for sale (buy) or for rent.", "default": "buy" }, "priceMin": { "title": "Minimum Price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Only return listings at or above this price in euros." }, "priceMax": { "title": "Maximum Price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Only return listings at or below this price in euros." } } }, "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 } } } } } } } } } }