{ "openapi": "3.0.1", "info": { "title": "Willhaben Listings Scraper & New-Ad Alerts (Austria)", "description": "Search willhaben.at, Austria's biggest classifieds site, by keyword or any search URL: one flat row per ad with title, price, location, publish time, seller type, photos and link. Real estate and used cars too. Newest first, with a 'published after' cutoff for new-ad alerts.", "version": "0.1", "x-build-id": "o2D62nY5MZFgOY482" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~willhaben-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-willhaben-listings", "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/superslowsloth~willhaben-listings/runs": { "post": { "operationId": "runs-sync-superslowsloth-willhaben-listings", "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/superslowsloth~willhaben-listings/run-sync": { "post": { "operationId": "run-sync-superslowsloth-willhaben-listings", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "What you would type into willhaben's marketplace search box, one keyword per line (for example fahrrad, iphone 14 or kühlschrank). Each keyword is searched on the marketplace (kaufen und verkaufen) and read separately. An ad that two searches both find is returned once, under the first.", "items": { "type": "string" } }, "startUrls": { "title": "Search URLs", "type": "array", "description": "Any willhaben search URL copied from your browser's address bar, one per line: a marketplace search with filters, a real-estate search (for example https://www.willhaben.at/iad/immobilien/mietwohnungen/mietwohnung-angebote) or a used-car search. The filters in the URL are kept. Its page, rows and sort parameters are replaced by this actor's own. Only URLs on willhaben.at under /iad/ are accepted. Use this, or Keywords, or both.", "items": { "type": "string" } }, "maxItems": { "title": "Max ads per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Read at most this many ads for each keyword and each URL. Willhaben serves up to 200 ads per request and 999 requests per search, so a very large search is read in part; narrow it with a more specific keyword or filters.", "default": 100 }, "sort": { "title": "Sort order", "enum": [ "newest", "relevance", "price-asc", "price-desc", "as-in-url" ], "type": "string", "description": "The order willhaben lists the results in. 'Newest first' puts the most recently published ads first, which is the order to use for new-listing alerts, and the actor checks that willhaben really applied it. 'Relevance' is willhaben's relevance order. 'Price' sorts by the ask (by rent in a rental search). 'As in the URL' sends no sort, so a start URL keeps the sort it was copied with.", "default": "newest" }, "publishedAfter": { "title": "Only ads published after", "type": "string", "description": "Optional. An ISO 8601 date or time, such as 2026-10-13 or 2026-10-13T08:00:00Z (UTC when no zone is given). Only ads published at or after it are returned, and the actor stops reading once a page is older than it, so a scheduled run that passes its last run's time pays only for the new ads. Needs the 'Newest first' sort." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy (automatic datacenter exits) is the default. Willhaben's Cloudflare layer refuses a share of exit addresses with a 403; the actor retries a refused request from a fresh address, which is what the proxy is for.", "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 }, "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 } } } } } } } } } }