# Kleinanzeigen API

> The Kleinanzeigen API by everydata.io returns live Kleinanzeigen data (classified ads search, ad details, categories) as structured JSON: 3 endpoints under /kla, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/kleinanzeigen
- Updated: 2026-11-02
- Publisher: everydata.io (https://everydata.io)

Kleinanzeigen API and scraper for kleinanzeigen.de (formerly eBay Kleinanzeigen), Germany's largest classifieds marketplace. Search ads by keyword, category, place and radius with filters for price range, seller type and offer/wanted, sort by newest to see new ads first, and fetch ad details: price and price type (fixed, negotiable, free), attributes like condition, brand, mileage, first registration, rooms and living space, category breadcrumb, place, images and shipping. Privacy by design: no seller names, user ids or contact data – only the seller type and the company name of commercial sellers; contact data in descriptions is redacted.

## Key facts

- Status: live
- Endpoints: 3 (path prefix `/kla`)
- Quota: A call to the Kleinanzeigen 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): 658 ms, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /kla/kleinanzeigen-search-by-keyword` – Search ads by keyword. Search Kleinanzeigen ads by keyword and/or category, optionally around a place (`location` = city or zip, resolved like the site's location box, or a numeric `locationId`; `radius` in km), with price range, seller type… Params: `keyword`?, `page`?, `categoryId`?, `location`?, `locationId`?, `radius`?, `minPrice`?, `maxPrice`?, `sortBy`?, `sellerType`?, `adType`?.
- `GET /kla/kleinanzeigen-lookup-ad` – Ad details by Kleinanzeigen URL. Ad details for a Kleinanzeigen ad URL (or the numeric `adId`): title, description (contact data redacted), price and price type, category breadcrumb, attributes (condition, brand, mileage, first registration, rooms, liv… Params: `url`?, `adId`?.
- `GET /kla/kleinanzeigen-categories` – Category tree. All Kleinanzeigen categories (main categories with their subcategories) with the `categoryId` used by /kleinanzeigen-search-by-keyword.

## Example

```bash
curl -s "https://api.everydata.io/kla/kleinanzeigen-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",
  "resultCount": 910973,
  "searchProductDetails": [
    {
      "productId": "3521408163",
      "productDescription": "Fahradkorb",
      "price": 5,
      "priceType": "Festpreis",
      "zip": "36100",
      "location": "Petersberg",
      "postedAt": "2026-09-23T20:20:00+02:00",
      "shippingPossible": true,
      "sellerType": "private",
      "dpUrl": "https://www.kleinanzeigen.de/s-anzeige/fahradkorb/3521408163-217-4616"
    }
  ]
}
```

## Use cases

- Used-goods price monitoring
- Car & real-estate market analysis
- Resale sourcing
- Brand & counterfeit monitoring

## FAQ

### What data does the Kleinanzeigen API return?

Classified ads search, ad details, categories. The API has 3 endpoints under the /kla path – search ads, ad details and categories – and every response is structured JSON that starts with responseStatus and responseMessage.

### How much does the Kleinanzeigen API cost?

A call to the Kleinanzeigen API counts as 1 request against the monthly quota. The Kleinanzeigen 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 Kleinanzeigen data realtime?

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

### Do I need a Kleinanzeigen account or an official Kleinanzeigen 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 Kleinanzeigen scraper?

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

### What happens when Kleinanzeigen 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 Kleinanzeigen API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every Kleinanzeigen 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)
