{ "openapi": "3.0.1", "info": { "title": "Biddit Scraper — Belgian Property Auctions & Public Sales", "description": "Extract Belgian property auctions from Biddit.be — the official notary platform. Get starting prices, current bids, estimated values, selling prices, notary contacts, EPC scores, GPS coordinates, and full property details. Filter by province, property type, or sale method. Schedule daily runs to ...", "version": "0.1", "x-build-id": "fkKfgcpGNK8vm2ItD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~biddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-biddit-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/studio-amba~biddit-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-biddit-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/studio-amba~biddit-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-biddit-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": { "province": { "title": "Province", "enum": [ "", "VAN", "VOV", "VWV", "VBR", "VLI", "BRU", "WBR", "WHT", "WLG", "WLX", "WNA" ], "type": "string", "description": "Filter by Belgian province. Leave empty for all provinces.", "default": "" }, "propertyType": { "title": "Property Type", "enum": [ "", "HOUSE", "APARTMENT", "GROUND", "GARAGE", "OFFICE", "INDUSTRY", "COMMERCIAL", "OTHER" ], "type": "string", "description": "Filter by property type. Leave empty for all types.", "default": "" }, "handlingMethod": { "title": "Sale Type", "enum": [ "", "ONLINE_PUBLIC_SALE", "PRIVATE_SALE", "ANNUITY_SALE" ], "type": "string", "description": "Filter by sale type. Public auctions are the most common on Biddit.", "default": "" }, "includeClosedSales": { "title": "Include Closed/Withdrawn Sales", "type": "boolean", "description": "Include listings that have already been sold or withdrawn. Useful for market analysis with historical selling prices.", "default": false }, "scrapeDetails": { "title": "Scrape Full Details", "type": "boolean", "description": "Fetch full details for each listing (description, all images, notary contact, documents). Slower but much richer data. Adds ~1 request per listing.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to return.", "default": 100 }, "language": { "title": "Language", "enum": [ "nl", "fr" ], "type": "string", "description": "Language for listing titles, descriptions, and addresses.", "default": "nl" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. biddit is fronted by F5 bot defense, which rejects a share of browser sessions whatever exit they come from — measured 2026-09-17, the same input passed and failed across consecutive runs on the same build, with and without a country pinned. The actor answers that by relaunching with a fresh fingerprint, so a rejected session is usually invisible to you. The default is a Belgian residential exit and a partial override merges over it, so you cannot accidentally drop the group or the country. Do not pin a country without a proxy group: Apify refuses that combination outright (NS_ERROR_PROXY_CONNECTION_REFUSED, run 35KFcYWftWhdxkYAX). The old note here about RESIDENTIAL exits hitting a content-filter block predates the Camoufox rewrite and no longer holds.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }