{ "openapi": "3.0.1", "info": { "title": "Willhaben Cars Scraper: Gebrauchtwagen Daten", "description": "Extract used-car listings (Gebrauchtwagen) from Willhaben.at, Austria's largest classifieds site, with price, year, mileage, fuel type, and seller filters applied to each listing. JSON or CSV rows ready for Sheets, Make, and Zapier.", "version": "0.1", "x-build-id": "FumoHQSnYb94dABXD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~willhaben-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-willhaben-cars-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/getascraper~willhaben-cars-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-willhaben-cars-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/getascraper~willhaben-cars-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-willhaben-cars-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": { "startUrls": { "title": "Custom Start URLs (optional)", "type": "array", "description": "Paste one or more Willhaben.at used-car listing links directly. When set, this replaces automatic discovery below. Leave empty to have the Actor discover listings on its own.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxListingsToScan": { "title": "Maximum Listings to Scan", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many listings to open and check against your filters while searching for matches. A higher number finds more matching results but takes longer. Ignored when Start URLs is set.", "default": 200 }, "priceFromEur": { "title": "Price From (EUR)", "minimum": 0, "type": "integer", "description": "Minimum asking price in euros." }, "priceToEur": { "title": "Price To (EUR)", "minimum": 0, "type": "integer", "description": "Maximum asking price in euros." }, "yearFrom": { "title": "Year From", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest model year." }, "yearTo": { "title": "Year To", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest model year." }, "mileageFromKm": { "title": "Mileage From (km)", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in kilometers." }, "mileageToKm": { "title": "Mileage To (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometers." }, "fuelTypes": { "title": "Fuel Type", "type": "array", "description": "Restrict to one or more fuel types, as published on the listing.", "items": { "type": "string", "enum": [ "Benzin", "Diesel", "Elektro", "Hybrid (Benzin)", "Hybrid (Diesel)", "Erdgas", "Autogas" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Petrol hybrid", "Diesel hybrid", "CNG", "LPG" ] }, "default": [] }, "transmissions": { "title": "Transmission", "type": "array", "description": "Restrict to one or more transmission types.", "items": { "type": "string", "enum": [ "Schaltgetriebe", "Automatik" ], "enumTitles": [ "Manual", "Automatic" ] }, "default": [] }, "sellerTypes": { "title": "Seller Type", "type": "array", "description": "Restrict to private sellers, dealers, or both.", "items": { "type": "string", "enum": [ "private", "dealer" ], "enumTitles": [ "Private seller", "Dealer" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy settings. Willhaben's listing and detail pages work with a direct connection by default.", "default": { "useApifyProxy": false } }, "maxItems": { "title": "Maximum Listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of matching car listings to return.", "default": 25 }, "sitemapIndexUrl": { "title": "Sitemap Index URL Override", "type": "string", "description": "Advanced: override the Willhaben sitemap index used for automatic discovery. Leave blank unless Willhaben changes its published sitemap location.", "default": "" } } }, "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 } } } } } } } } } }