{ "openapi": "3.0.1", "info": { "title": "Willhaben Properties Scraper (Austria)", "description": "Scrapes property listings from Willhaben, Austria's largest classifieds site, across rentals, apartments for sale, houses for sale and land. Every row carries price, price per m², rooms, living area, address, GPS coordinates, agency and images.", "version": "0.1", "x-build-id": "Y4ypuKAJB4GOu4msa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~willhaben-properties-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-willhaben-properties-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/scrapyx~willhaben-properties-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-willhaben-properties-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/scrapyx~willhaben-properties-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-willhaben-properties-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": { "queries": { "title": "Search queries", "type": "array", "description": "One {category, region} pair per entry, each with its own SEARCH_SUMMARY row. `category` must be one of `rent_apartment`, `buy_apartment`, `buy_house`, `land`. `region` is one of Austria's 9 states (e.g. `wien`, `steiermark`) or empty for all of Austria.\n\nExample:\n```json\n[{\"category\": \"rent_apartment\", \"region\": \"wien\"}, {\"category\": \"buy_house\", \"region\": \"tirol\"}]\n```", "default": [] }, "sort": { "title": "Sort order", "enum": [ "", "1", "2", "3", "4", "5", "6", "7" ], "type": "string", "description": "Each value here is one of Willhaben's own sortOrderList options, read from the page rather than guessed.", "default": "" }, "rooms": { "title": "Number of rooms (exact)", "minimum": 0, "maximum": 20, "type": "integer", "description": "Verified real: `3` narrowed Wien rentals from 4,810 to 1,340. This is an EXACT match, not a minimum — Willhaben's own filter behaves the same way. Leave at 0 to skip.", "default": 0 }, "priceFrom": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Verified real and composes correctly with priceTo. Leave at 0 to skip.", "default": 0 }, "priceTo": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Verified real: `800` narrowed Wien rentals from 4,810 to 366. Leave at 0 to skip.", "default": 0 }, "includePropertyDetails": { "title": "Fetch full property details", "type": "boolean", "description": "Adds one request per listing and attaches a `detail` object with the full description text, equipment list, contact details, and category-specific attributes not present on the search row.\n\nOff by default — search rows already carry price, price/m², rooms, living area, address, coordinates, agency and images.", "default": false }, "maxItems": { "title": "Max listings per query", "minimum": 0, "type": "integer", "description": "Stop after this many listings per (category, region) query. Set to 0 for everything Willhaben will serve.", "default": 100 }, "pageSize": { "title": "Rows per request", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many listings to pull per request. 200 is the maximum Willhaben honours — anything higher is silently clamped to 200, not rejected.", "default": 90 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 16, "type": "integer", "description": "Upper bound on requests in flight at once, across all queries and any detail fetches.", "default": 4 }, "minRequestInterval": { "title": "Minimum seconds between requests", "minimum": 0, "maximum": 30, "type": "integer", "description": "Paces how often requests START, without tying up a concurrency slot. Leave at 0 to use the built-in default of 0.2s -- 0 does not mean 'no pacing'.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy on the shared datacenter pool. This is the default because it is included in your plan at no extra cost and this target works through it. If you start seeing blocks, challenges or empty results, switch the group here to Residential -- it uses real consumer IPs and gets through more, but Apify bills residential traffic per gigabyte, so leave it off unless you need it.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }