# willhaben Classifieds API

> The willhaben Classifieds API by everydata.io returns live willhaben data (austrian classifieds, real estate & cars: search, ad details, categories) as structured JSON: 3 endpoints under /wlh, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/willhaben
- Updated: 2026-10-22
- Publisher: everydata.io (https://everydata.io)

Search willhaben.at – Austria's largest marketplace for classifieds, real estate and cars – by keyword, category, place, price range and seller type, in the marketplace or in the rent/buy real-estate and vehicle search areas, and fetch ad details: price, attributes, category breadcrumb, place, images and seller type. Real-estate ads come with offer type, property type, living space, rooms, price per m², additional costs, floor, year built and energy class; car ads with make, model, mileage, first registration, fuel, power and gearbox. Privacy by design: no seller names, user ids or contact data – only the seller type and the company name of businesses; contact data in descriptions is redacted.

## Key facts

- Status: beta
- Endpoints: 3 (path prefix `/wlh`)
- Quota: A call to the willhaben API counts as 1 request against the monthly quota.
- Pricing: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). One quota is shared across all 34 platforms; failed requests (5xx, blocked pages) are not counted.
- Measured average response time (last 24 h): 1.9 s, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /wlh/willhaben-search-by-keyword` – Search ads by keyword. Search willhaben.at – Austria's largest classifieds, real-estate and car marketplace – by keyword and/or category in one search area (`vertical`: marketplace, realestate, flat-rent, flat-buy, house-rent, house-buy, plot… Params: `keyword`?, `page`?, `vertical`?, `categoryId`?, `location`?, `locationId`?, `minPrice`?, `maxPrice`?, `sortBy`?, `sellerType`?.
- `GET /wlh/willhaben-lookup-ad` – Ad details by willhaben URL. Ad details for a willhaben.at ad URL (or the numeric `adId`) from any search area: title, description and description sections (contact data redacted), price, category breadcrumb, attributes and features, zip/place/dist… Params: `url`?, `adId`?.
- `GET /wlh/willhaben-categories` – Categories and search areas. The willhaben marketplace main categories with the `categoryId` used by /willhaben-search-by-keyword (and their current ad counts), plus all search areas (`vertical`) for real estate and vehicles.

## Example

```bash
curl -s "https://api.everydata.io/wlh/willhaben-search-by-keyword?keyword=fahrrad&sortBy=newest" \
  -H "x-api-key: YOUR_API_KEY"
```

```json
{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "keyword": "fahrrad",
  "vertical": "marketplace",
  "resultCount": 95735,
  "searchProductDetails": [
    {
      "productId": "1655995017",
      "productDescription": "Van RYSEL 28 Zoll GRVL AF Shimano GRX 2x12",
      "price": 1500,
      "currency": "EUR",
      "zip": "8750",
      "location": "Judenburg",
      "postedAt": "2026-09-24T08:06:43+00:00",
      "sellerType": "private",
      "dpUrl": "https://www.willhaben.at/iad/kaufen-und-verkaufen/d/van-rysel-28-zoll-grvl-af-shimano-grx-2x12-1655995017/"
    }
  ]
}
```

## Use cases

- Austrian rent & property price research
- Used-car and used-goods price monitoring
- Resale sourcing
- Dealer & agency stock tracking

## FAQ

### What data does the willhaben Classifieds API return?

Austrian classifieds, real estate & cars: search, ad details, categories. The API has 3 endpoints under the /wlh path – search ads, ad details and categories – and every response is structured JSON that starts with responseStatus and responseMessage.

### What does “beta” mean for the willhaben API?

The endpoints and response fields are usable today, but they can still change and the platform is not yet counted in the headline success rate. Blocked or failed calls are not billed.

### How much does the willhaben API cost?

A call to the willhaben API counts as 1 request against the monthly quota. The willhaben API is included in every plan and shares one quota with all other platforms: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). Failed requests (5xx, blocked pages) are not counted.

### Is the willhaben data realtime?

Yes. Each request loads the live willhaben page when you call the API – there is no database of old snapshots in between.

### Do I need a willhaben account or an official willhaben API key?

No. You only need an everydata.io API key, sent in the x-api-key header. The free plan works without a credit card.

### Is this a willhaben scraper?

It replaces one. everydata.io loads the live willhaben pages for you and returns parsed JSON fields, so you do not build or maintain a willhaben scraper, parser or proxy setup yourself. Retries are included, and a request that still fails costs no quota.

### What happens when willhaben blocks a request?

The API retries the fetch automatically. If the page still cannot be loaded you get a 502 or 503 error, and that request costs no quota. Success rates and response times per platform are measured around the clock on the status page.

### Can ChatGPT, Claude or an AI agent use the willhaben API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every willhaben endpoint as a tool, or register the plain HTTPS endpoints as functions in any agent framework. The endpoint list is also in /llms.txt and the OpenAPI spec.

## More

- [All platforms](https://everydata.io/apis) · [Pricing](https://everydata.io/pricing) · [API reference](https://everydata.io/docs) · [Getting started](https://everydata.io/docs/getting-started) · [MCP server](https://everydata.io/docs/mcp) · [Status](https://everydata.io/status)
- Machine-readable: [llms.txt](https://everydata.io/llms.txt), [llms-full.txt](https://everydata.io/llms-full.txt), [OpenAPI](https://api.everydata.io/openapi.json)
