{ "openapi": "3.0.1", "info": { "title": "Immoweb.be Scraper with Contacts | Fast & Reliable", "description": "Extract unlimited Immoweb.be property listings across Belgium with rich property detail, agency contacts, EPC data, media, pricing, and flexible market filters. Built for enterprise-grade Belgian real estate intelligence, lead enrichment, and automated analytics pipelines.", "version": "0.0", "x-build-id": "8JJNAW6o1Q5LlFxA3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~immoweb-be-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-immoweb-be-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/fatihtahta~immoweb-be-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-immoweb-be-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/fatihtahta~immoweb-be-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-immoweb-be-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": { "deal_type": { "title": "Choose Sale or Rent Listings", "enum": [ "buy", "rent" ], "type": "string", "description": "Select the listing mode to collect. Choose sale for purchase opportunities or rent for rental listings; the default starts with properties for sale.", "default": "buy" }, "property_type": { "title": "Choose Property Category", "enum": [ "house", "apartment", "house_and_apartment", "kot", "garage", "office", "business", "industry", "land", "other" ], "type": "string", "description": "Choose the category of listings to collect. The default searches houses and apartments together, which is a practical starting point for residential market research.", "default": "house_and_apartment" }, "location": { "title": "Add Belgian Search Area", "type": "string", "description": "Enter a Belgian city, postal code, district, province, neighborhood, or market. Use a specific area for targeted collection, or leave it empty to keep the search national." }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Enter the lowest price to include. For rent searches, this applies to the rental price; for sale searches, it applies to the listing price." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Enter the highest price to include. Leave this empty when you do not want to cap the upper end of the market." }, "min_building_year": { "title": "Set Earliest Building Year", "minimum": 0, "type": "integer", "description": "Include only properties built in or after this year. Leave empty to avoid applying a lower construction-year boundary." }, "max_building_year": { "title": "Set Latest Building Year", "minimum": 0, "type": "integer", "description": "Include only properties built in or before this year. Leave empty to avoid applying an upper construction-year boundary." }, "immediately_available": { "title": "Require Immediate Availability", "type": "boolean", "description": "Turn this on when move-in timing is important and you only want listings marked as immediately available.", "default": false }, "min_area": { "title": "Set Minimum Living Area", "minimum": 0, "type": "integer", "description": "Enter the minimum living area in square meters. Leave empty when smaller homes should stay in the results." }, "max_area": { "title": "Set Maximum Living Area", "minimum": 0, "type": "integer", "description": "Enter the maximum living area in square meters. Leave empty when larger homes should stay in the results." }, "min_bedroom": { "title": "Set Minimum Bedrooms", "minimum": 0, "type": "integer", "description": "Enter the fewest bedrooms a listing should have. Leave empty to include studios and listings with any bedroom count." }, "max_bedroom": { "title": "Set Maximum Bedrooms", "minimum": 0, "type": "integer", "description": "Enter the most bedrooms a listing should have. Leave empty when larger properties should stay in the results." }, "min_parking": { "title": "Set Minimum Parking Spaces", "minimum": 0, "type": "integer", "description": "Enter the minimum number of parking spaces required. Leave empty to include listings regardless of parking count." }, "3d_tour": { "title": "Require a 3D Tour", "type": "boolean", "description": "Turn this on when remote review quality matters and you only want listings with virtual-tour media.", "default": false }, "epc_label": { "title": "Choose EPC Labels", "uniqueItems": true, "type": "array", "description": "Choose one or more EPC energy labels to include. Leave empty to collect listings across all available EPC ratings.", "items": { "type": "string", "enum": [ "A++", "A+", "A", "B", "C", "D", "E", "F", "G", "X" ], "enumTitles": [ "A++", "A+", "A", "B", "C", "D", "E", "F", "G", "X" ] } }, "sort_by": { "title": "Choose Result Order", "enum": [ "relevance", "cheapest", "most_expensive", "postal_code", "newest" ], "type": "string", "description": "Order matching listings by relevance, price, postal code, or recent listing activity.", "default": "relevance" }, "enrich_data": { "title": "Collect Richer property listing Details", "type": "boolean", "description": "Enable this for more complete property listings. This may make the run slower because the actor may spend more time collecting details for each result. Turn it off for faster runs when the standard result fields are enough.", "default": true }, "maximize_coverage": { "title": "Collect More Matching Listings", "type": "boolean", "description": "Keep this enabled for large searches that may exceed the visible-result limit. Turn it off for faster exploratory runs where the first visible set of matching listings is enough.", "default": true }, "limit": { "title": "Set Maximum Results", "minimum": 1, "type": "integer", "description": "Set the maximum number of listings to save for the search. Leave empty to collect as many matching listings as are available." } } }, "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 } } } } } } } } } }