# Willhaben.at $1πŸ’° URL Search | Keyword Filtering | Rich Output (`abotapi/willhaben-at-scraper`) Actor From $1/1K. Extract structured listing data directly from Willhaben.at into clean JSON with 40+ fields, including GPS coordinates, photos, dates, seller details, and category-specific attributes. Search by filters or any Willhaben URL. - **URL**: https://apify.com/abotapi/willhaben-at-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Real estate, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Willhaben.at Scraper Willhaben.at is Austria's largest online marketplace, covering general goods, property, used cars, and jobs. This actor pulls structured listing data straight from willhaben's own data source, so you get clean JSON with roughly 40 fields per ad (often many more), including full geo coordinates, every photo, dates, seller type, and per-category attributes. Build a search from filters, or paste any willhaben search-page URL. ### Why This Scraper? - Roughly 40 base fields per listing, plus every category-specific attribute flattened into the record (cars get make, model, mileage, year, fuel, transmission, equipment; property gets rooms, living area, floor, price per square meter). - Two ways to start: a search builder (category, keyword, price range, location, sort) and a paste-URLs mode that accepts any willhaben search page. - GPS latitude and longitude, full address hierarchy (state, district, postcode, municipality), and all photo URLs on every record. - Optional detail enrichment adds contact name, dealer or organisation info, address detail, and the complete attribute set. - Fast: reads willhaben's structured data directly instead of rendering pages, with concurrent detail fetching. - Automatic forward pagination with de-duplication across pages. ### Data You Get > Sample shape: values are illustrative placeholders, not from a live listing. | Field | Example | |---|---| | id | 000000001 | | url | https://www.willhaben.at/iad/gebrauchtwagen/d/auto/sample-000000001/ | | title | Sample Listing Title | | description | Full listing description text appears here. | | price | 7800 | | priceDisplay | € 7.800 | | category | gebrauchtwagen/auto/gebrauchtwagenboerse | | make | SampleMake | | model | SampleModel | | mileage | 120000 | | year | 2019 | | fuel | Benzin | | transmission | Automatik | | condition | Gebrauchtwagen | | state | Wien | | district | Wien | | postcode | 1010 | | locationName | Sample Location | | latitude | 48.2000 | | longitude | 16.3700 | | publishedDate | 2026-01-01T00:00:00.000Z | | advertiserLabel | Privat | | isPrivate | true | | imageCount | 12 | | mainImage | https://cache.willhaben.at/mmo/0/000/000/000_0.jpg | | images | ["https://cache.willhaben.at/mmo/0/000/000/000_0.jpg", ...] | | contactName | A. B. | | organisationName | Sample Dealer | Plus an `attr_*` key for every raw attribute the category exposes, and a `rawAttributes` array preserving the original structure. ### How to Use Search a category (used cars), list-only: ```json { "mode": "search", "category": "gebrauchtwagen/auto/gebrauchtwagenboerse", "maxListings": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" } } ```` Search the marketplace by keyword with a price range: ```json { "mode": "search", "category": "kaufen-und-verkaufen/marktplatz", "keyword": "iphone", "minPrice": 100, "maxPrice": 500, "sort": "price-asc", "maxListings": 200, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" } } ``` Rentals in Vienna with detail enrichment: ```json { "mode": "search", "category": "immobilien/mietwohnungen", "areaId": 900, "fetchDetails": true, "maxListings": 50, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" } } ``` Search jobs by keyword: ```json { "mode": "search", "category": "jobs", "keyword": "python", "sort": "newest", "maxListings": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" } } ``` Paste any willhaben search URLs (multi-URL, forward pagination): ```json { "mode": "url", "urls": [ "https://www.willhaben.at/iad/immobilien/eigentumswohnung/wien", "https://www.willhaben.at/iad/gebrauchtwagen/auto/gebrauchtwagenboerse?YEAR_MODEL_FROM=2018" ], "maxPages": 5, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" } } ``` ### Input Parameters | Parameter | Type | Default | Description | |---|---|---|---| | mode | string | search | "search" builds a query from filters; "url" scrapes pasted search pages. | | category | string | kaufen-und-verkaufen/marktplatz | Section to scrape (Search mode). Includes Jobs, which returns job-specific fields (company, salary, employment type) and ignores the price and area filters. | | categoryPath | string | (empty) | Advanced: override category with any willhaben SEO path. | | keyword | string | (empty) | Free-text keyword within the category. | | areaId | integer | (empty) | willhaben location ID, for example 900 for Vienna. | | minPrice | integer | (empty) | Minimum price in euros. | | maxPrice | integer | (empty) | Maximum price in euros. | | sort | string | default | One of default, newest, price-asc, price-desc. | | customParameters | array | \[] | Extra raw willhaben filters as KEY=VALUE strings. | | urls | array | (example) | Search-page URLs (URL mode). | | fetchDetails | boolean | false | Open each detail page for contact and dealer info. | | maxListings | integer | 20 | Maximum listings across all searches (0 for unlimited). | | maxPages | integer | 500 | Maximum pages per search (about 25 listings per page). Defaults high so `maxListings` is the effective hard cap. | | proxy | object | Residential AT | Proxy settings. Residential Austria is required. | ### Output Example > Sample shape: values are illustrative placeholders, not from a live listing. ```json { "id": "000000001", "uuid": "00000000-0000-0000-0000-000000000000", "url": "https://www.willhaben.at/iad/gebrauchtwagen/d/auto/sample-000000001/", "title": "Sample Listing Title", "description": "Full listing description text appears here.", "price": 7800, "priceDisplay": "€ 7.800", "category": "gebrauchtwagen/auto/gebrauchtwagenboerse", "make": "SampleMake", "model": "SampleModel", "mileage": 120000, "year": 2019, "fuel": "Benzin", "transmission": "Automatik", "condition": "Gebrauchtwagen", "country": "Γ–sterreich", "state": "Wien", "district": "Wien", "postcode": "1010", "locationName": "Sample Location", "latitude": 48.2000, "longitude": 16.3700, "publishedDate": "2026-01-01T00:00:00.000Z", "changedDate": "2026-01-01T00:00:00.000Z", "isPrivate": true, "advertiserLabel": "Privat", "imageCount": 2, "mainImage": "https://cache.willhaben.at/mmo/0/000/000/000_0.jpg", "images": [ "https://cache.willhaben.at/mmo/0/000/000/000_0.jpg", "https://cache.willhaben.at/mmo/0/000/000/000_1.jpg" ] } ``` ### Plan Requirement willhaben.at accepts traffic only from Austrian (or nearby EU) residential connections; datacenter proxies are rejected. Use an Apify plan that includes Residential proxy (Starter or higher) and set the proxy country to AT. The actor automatically rotates AT and DE residential exits and falls back to a backup route if needed. On the free plan, residential proxy is not available, so runs may return no results; the actor logs guidance when that happens. # Actor input Schema ## `mode` (type: `string`): How to find listings: build a search from filters, or paste search-page URLs. ## `category` (type: `string`): Listing category (Search mode). Pick a section of willhaben.at to scrape. ## `categoryPath` (type: `string`): Optional. Override Category with any willhaben SEO path, e.g. 'immobilien/anlageobjekte' or 'gebrauchtwagen/motorrad'. Leave empty to use the Category above. Copy the path that follows '/iad/' from a willhaben URL. ## `keyword` (type: `string`): Free-text keyword to search within the category, e.g. 'iphone', 'bmw', 'altbau'. Leave empty to list everything in the category. ## `areaId` (type: `integer`): Optional willhaben location ID to restrict results to a region/district. Example: 900 = Vienna (Wien). Find the ID in the URL after picking a location on willhaben.at. Leave empty for all of Austria. Not applied to the Jobs category. ## `minPrice` (type: `integer`): Minimum price filter. Leave empty for no minimum. Not applied to the Jobs category. ## `maxPrice` (type: `integer`): Maximum price filter. Leave empty for no maximum. ## `sort` (type: `string`): Result ordering (Search mode). ## `customParameters` (type: `array`): Optional raw willhaben query parameters as KEY=VALUE strings, e.g. 'YEAR\_MODEL\_FROM=2018', 'MILEAGE\_TO=100000', 'CAR\_MODEL/MAKE=139'. Lets you replicate any filter the site offers. One per line. ## `urls` (type: `array`): willhaben.at search-page URLs to scrape (URL mode). Multi-URL supported. Filter fields above are ignored in this mode. Pagination starts at the page in the URL and walks forward. ## `fetchDetails` (type: `boolean`): Open each listing's detail page to add contact name, dealer/organisation info, address detail and the full attribute set. Slower and costs an extra fetch per listing. Leave off for fast list-only scraping (the list already carries ~40 fields). ## `maxListings` (type: `integer`): Maximum number of listings to scrape across all searches. Set 0 for unlimited. ## `maxPages` (type: `integer`): Maximum pages to paginate per search (~25 listings/page). Defaults to the highest allowed value so Max listings is the effective hard cap. ## `proxy` (type: `object`): willhaben.at only accepts traffic from Austrian (or nearby EU) residential connections. Datacenter proxies are rejected. Use Apify Residential with country AT for reliable results. The actor rotates AT and DE residential exits automatically. ## Actor input object example ```json { "mode": "search", "category": "kaufen-und-verkaufen/marktplatz", "sort": "default", "customParameters": [], "urls": [ "https://www.willhaben.at/iad/gebrauchtwagen/auto/gebrauchtwagenboerse" ], "fetchDetails": false, "maxListings": 20, "maxPages": 500, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AT" } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "customParameters": [], "urls": [ "https://www.willhaben.at/iad/gebrauchtwagen/auto/gebrauchtwagenboerse" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AT" } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/willhaben-at-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "customParameters": [], "urls": ["https://www.willhaben.at/iad/gebrauchtwagen/auto/gebrauchtwagenboerse"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT", }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/willhaben-at-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "customParameters": [], "urls": [ "https://www.willhaben.at/iad/gebrauchtwagen/auto/gebrauchtwagenboerse" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AT" } }' | apify call abotapi/willhaben-at-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/willhaben-at-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Willhaben.at $1πŸ’° URL Search | Keyword Filtering | Rich Output", "description": "From $1/1K. Extract structured listing data directly from Willhaben.at into clean JSON with 40+ fields, including GPS coordinates, photos, dates, seller details, and category-specific attributes. Search by filters or any Willhaben URL.", "version": "1.0", "x-build-id": "yMSpRIPZjVKklN3al" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~willhaben-at-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-willhaben-at-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/abotapi~willhaben-at-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-willhaben-at-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/abotapi~willhaben-at-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-willhaben-at-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to find listings: build a search from filters, or paste search-page URLs.", "default": "search" }, "category": { "title": "Category", "enum": [ "kaufen-und-verkaufen/marktplatz", "immobilien/mietwohnungen", "immobilien/eigentumswohnung", "immobilien/haus-kaufen", "immobilien/haus-mieten", "immobilien/grundstuecke", "gebrauchtwagen/auto/gebrauchtwagenboerse", "gebrauchtwagen/wohnwagen-wohnmobile", "jobs" ], "type": "string", "description": "Listing category (Search mode). Pick a section of willhaben.at to scrape.", "default": "kaufen-und-verkaufen/marktplatz" }, "categoryPath": { "title": "Custom category path (advanced)", "type": "string", "description": "Optional. Override Category with any willhaben SEO path, e.g. 'immobilien/anlageobjekte' or 'gebrauchtwagen/motorrad'. Leave empty to use the Category above. Copy the path that follows '/iad/' from a willhaben URL." }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text keyword to search within the category, e.g. 'iphone', 'bmw', 'altbau'. Leave empty to list everything in the category." }, "areaId": { "title": "Area ID (location)", "type": "integer", "description": "Optional willhaben location ID to restrict results to a region/district. Example: 900 = Vienna (Wien). Find the ID in the URL after picking a location on willhaben.at. Leave empty for all of Austria. Not applied to the Jobs category." }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price filter. Leave empty for no minimum. Not applied to the Jobs category." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price filter. Leave empty for no maximum." }, "sort": { "title": "Sort by", "enum": [ "default", "newest", "price-asc", "price-desc" ], "type": "string", "description": "Result ordering (Search mode).", "default": "default" }, "customParameters": { "title": "Extra filters (advanced)", "type": "array", "description": "Optional raw willhaben query parameters as KEY=VALUE strings, e.g. 'YEAR_MODEL_FROM=2018', 'MILEAGE_TO=100000', 'CAR_MODEL/MAKE=139'. Lets you replicate any filter the site offers. One per line.", "items": { "type": "string" } }, "urls": { "title": "Search URLs", "type": "array", "description": "willhaben.at search-page URLs to scrape (URL mode). Multi-URL supported. Filter fields above are ignored in this mode. Pagination starts at the page in the URL and walks forward.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Open each listing's detail page to add contact name, dealer/organisation info, address detail and the full attribute set. Slower and costs an extra fetch per listing. Leave off for fast list-only scraping (the list already carries ~40 fields).", "default": false }, "maxListings": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape across all searches. Set 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum pages to paginate per search (~25 listings/page). Defaults to the highest allowed value so Max listings is the effective hard cap.", "default": 500 }, "proxy": { "title": "Proxy", "type": "object", "description": "willhaben.at only accepts traffic from Austrian (or nearby EU) residential connections. Datacenter proxies are rejected. Use Apify Residential with country AT for reliable results. The actor rotates AT and DE residential exits automatically." } } }, "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 } } } } } } } } } } ```