# Kleinanzeigen Scraper – Listings, Prices, Sellers & Alerts (`liveclaude/kleinanzeigen-scraper`) Actor

Scrape Kleinanzeigen.de (ex eBay Kleinanzeigen) listings with every filter or any URL: prices, price drops, full details, photos, GPS, seller profiles and PRO shops, no 1,250-result limit, and monitoring of new, reduced and sold listings.

- **URL**: https://apify.com/liveclaude/kleinanzeigen-scraper.md
- **Developed by:** [FlareWOW](https://apify.com/liveclaude) (community)
- **Categories:** E-commerce, Real estate, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 listings

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Kleinanzeigen Scraper by FlareWOW](https://api.apify.com/v2/key-value-stores/IqbQl1JBP48qtbcrc/records/cover.png)

## Kleinanzeigen Scraper: listings, sellers, price drops and monitoring

**From $0.90 per 1,000 listings.** Scrape **Kleinanzeigen.de** (formerly eBay Kleinanzeigen), Germany's biggest classifieds site, with **every search filter** or **any Kleinanzeigen URL**. Get prices, **price reductions**, location, photos, full descriptions, all attributes (brand, model, mileage, rooms...), **GPS coordinates**, **seller profiles and PRO shops**, and **monitor new listings, price drops and sold listings** on a schedule. No 1,250-result limit, no login, no proxy setup.

🌐 **Read in your language:** 🇩🇪 [Deutsch](#-deutsch) · 🇵🇱 [Polski](#-polski) · 🇫🇷 [Français](#-français) · 🇪🇸 [Español](#-español) · 🇮🇹 [Italiano](#-italiano) · 🇳🇱 [Nederlands](#-nederlands)

### ✨ What you get

| | |
|---|---|
| 🔎 Search like on the site | keywords, 150+ categories, city or postcode **+ radius**, price range, private / commercial sellers, offers / wanted, shipping or pickup, "Direkt kaufen", sorting (newest, cheapest, most expensive, nearest) |
| 🔗 Any URL | paste a search or category link with **category-specific filters** (mileage, first registration, rooms, living space, storage, brand...), a single listing, a seller page or a PRO shop |
| ♾️ No 1,250 limit | Kleinanzeigen shows max. 50 pages per search - big searches are split into price ranges automatically |
| 📉 Price reductions | every listing has `originalPrice` and `priceReduced` when the seller lowered the price |
| 📄 Listing details | full description, all attributes, equipment list, all photos, GPS coordinates, shipping cost, posting date, seller name, type, rating badges, member since |
| 👤 Sellers & PRO shops | seller profile (badges, followers, reply time, active since) and all listings; PRO shops with **company name, business phone, address, website and opening hours** |
| 🔔 Monitoring | only new listings, **price drops** and **sold / reserved / deleted listings with days on market** |
| ⏱️ Posted within X hours | e.g. only the last 24 hours - fast and cheap for daily alerts |
| 📊 Price summary | min / quartiles / median / average / max per search, share of negotiable (VB), reduced and shippable listings, top locations |
| 💰 Price | **from $0.90 / 1,000 listings**, start fee $0.00005 |

### 🚀 How to use it

1. **Type search terms** (e.g. `iphone 15`, `sofa`, `golf 7`) and optionally pick categories, a **location** (`Berlin`, `80331`) and a **radius**.
2. **Or paste a link**: set filters on kleinanzeigen.de in your browser, copy the URL and paste it into **Kleinanzeigen URLs**. All filters in the URL are kept, also the category-specific ones.
3. Turn on **Listing details** if you need the full description, attributes, photos and GPS.
4. Add **sellers** (user ID, seller link or PRO shop like `cartech`) to track them.
5. Click **Start** and download Excel, CSV or JSON, or connect via API, Make, Zapier, n8n or Google Sheets.

### 🔔 Monitoring (alerts for new listings and price drops)

Turn on **Only new listings** and schedule the Actor (e.g. every hour). Each run returns only listings you have not seen yet, plus **price drops** and listings that were **sold, reserved or deleted** (with `daysOnMarket`). Every record has `listingStatus`: `new`, `price-drop`, `sold`, `reserved` or `removed`. You only pay for what is new. Combine with **Posted within (hours)** for the cheapest alerts.

For very big searches (more than 2,000 results) repeated monitoring runs read the newest listings until they reach ones already known, so they stay fast. Sold detection and price drops of older listings work for searches up to 2,000 results - narrow big searches with a location, category or price range.

### 📦 Output example

![Results](https://api.apify.com/v2/key-value-stores/IqbQl1JBP48qtbcrc/records/screen-results.png)

```json
{
  "id": "3522579203",
  "url": "https://www.kleinanzeigen.de/s-anzeige/peugeot-5008-allure-pack-130-eat8-automatik-7-sitzer/3522579203-216-1030",
  "title": "Peugeot 5008 Allure Pack 130 EAT8 Automatik 7-Sitzer",
  "price": 21000,
  "priceType": "negotiable",
  "originalPrice": 22000,
  "priceReduced": true,
  "currency": "EUR",
  "postalCode": "57078",
  "city": "Siegen",
  "postedAt": "2026-10-16T09:30:00.000Z",
  "mileageKm": 25000,
  "firstRegistration": "2023-02",
  "categoryPath": "Auto, Rad & Boot > Autos",
  "attributes": {
    "Marke": "Peugeot",
    "Modell": "5008",
    "Kilometerstand": "25.000 km",
    "Fahrzeugzustand": "Unbeschädigtes Fahrzeug",
    "Erstzulassung": "Februar 2023",
    "Kraftstoffart": "Benzin",
    "Leistung": "131 PS",
    "Getriebe": "Automatik",
    "Fahrzeugtyp": "Van/Bus",
    "Anzahl Türen": "4/5",
    "HU bis": "Dezember 2027",
    "Umweltplakette": "4 (Grün)",
    "Schadstoffklasse": "Euro6",
    "Außenfarbe": "Blau",
    "Material Innenausstattung": "Teilleder"
  },
  "features": [
    "Einparkhilfe",
    "Leichtmetallfelgen",
    "Xenon-/LED-Scheinwerfer",
    "Klimaanlage",
    "Navigationssystem"
  ],
  "latitude": 50.9167927,
  "longitude": 7.988192,
  "imageCount": 11,
  "sellerType": "private",
  "sellerActiveSince": "2018-09-24",
  "sellerBadges": [
    "OK Zufriedenheit",
    "Freundlich"
  ],
  "isTopAd": false
}
```

Table views: **Listings**, **Listing details**, **Monitoring**, **Sellers & shops**, **Price summaries**. Cars include `mileageKm` and `firstRegistration`, real estate includes `livingSpaceM2` and `rooms` already in the search results.

### 💰 Pricing

Pay only for results. The price depends on your Apify plan:

| Event | Free | Starter | Scale | Business |
|---|---|---|---|---|
| Listing | $1.30 / 1k | $1.20 / 1k | $1.05 / 1k | **$0.90 / 1k** |
| ➕ Listing details (optional) | $1.20 / 1k | $1.10 / 1k | $1.00 / 1k | $0.90 / 1k |
| Seller / shop profile | $2.00 / 1k | $1.80 / 1k | $1.60 / 1k | $1.50 / 1k |
| Price summary | $0.01 | $0.01 | $0.01 | $0.01 |

Listings removed by your filters, already seen listings in monitoring mode and failed pages are **free**. Set a maximum cost per run in the run options and the Actor stops exactly there.

### ❓ FAQ

**Do I need a Kleinanzeigen account or proxies?** No. Apify Proxy is included.

**Can I get phone numbers or e-mails of private sellers?** No. Kleinanzeigen hides them and the Actor does not collect private contact data. PRO shops publish their business contact on their shop page - that is included in the seller record.

**Why do some listings have no price?** Listings with only "VB" (negotiable) or "Zu verschenken" (free, price 0) have no fixed amount.

**What are TOP ads?** Promoted listings shown at the top of results (`isTopAd: true`). Turn off **Include TOP ads** to keep only organic results.

**Is it legal?** The Actor collects publicly available data. You are responsible for using it in line with Kleinanzeigen's terms and data protection law (GDPR).

***

### Input example

```json
{
  "searchQueries": [
    "iphone 15"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

Every field is described in the **Input** tab.

### Integrations & API

- **API**: start the Actor and fetch results via the [Apify API](https://docs.apify.com/api/v2) – clients for Python and JavaScript, or plain HTTP.
- **No-code**: connect results to **Make, Zapier, n8n, Google Sheets, Slack, Airbyte** or any webhook.
- **AI agents**: call `liveclaude/kleinanzeigen-scraper` from Claude, ChatGPT or Cursor through the [Apify MCP server](https://mcp.apify.com).

### 🇩🇪 Deutsch

**Kleinanzeigen Scraper** liest Anzeigen von **Kleinanzeigen.de** (ehemals eBay Kleinanzeigen) **ab $0.90 pro 1.000 Anzeigen**.

- **Suchbegriffe, 150+ Kategorien, Ort oder PLZ mit Umkreis**, Preisspanne, privat / gewerblich, Angebote / Gesuche, Versand oder Abholung, "Direkt kaufen", Sortierung (neueste, günstigste, teuerste, nächste).
- **Beliebigen Link einfügen**: Such- und Kategorieseiten mit allen Filtern (auch Kilometerstand, Erstzulassung, Zimmer, Wohnfläche, Speicher, Marke...), einzelne Anzeigen, Verkäuferseiten und PRO-Shops.
- **Kein Limit von 1.250 Ergebnissen** - große Suchen werden automatisch nach Preis aufgeteilt.
- **Preissenkungen** (`originalPrice`, `priceReduced`) direkt aus den Suchergebnissen.
- **Anzeigendetails**: komplette Beschreibung, alle Merkmale, Ausstattung, alle Fotos, GPS-Koordinaten, Versandkosten, Verkäufer, Bewertungs-Abzeichen, aktiv seit.
- **Verkäufer & PRO-Shops verfolgen**: Profil und alle Anzeigen; bei PRO-Shops Firmenname, Telefon, Adresse, Website und Öffnungszeiten.
- **Monitoring**: nur neue Anzeigen, **Preissenkungen** und **verkaufte / reservierte / gelöschte Anzeigen** mit Standzeit. Ideal als stündlicher Suchauftrag.
- **Nur Anzeigen der letzten X Stunden** und **Preisübersicht** (Median, Quartile, Anteil VB) pro Suche.

### 🇵🇱 Polski

**Kleinanzeigen Scraper** pobiera ogłoszenia z **Kleinanzeigen.de** (dawniej eBay Kleinanzeigen), największego serwisu ogłoszeń w Niemczech, **od $0.90 za 1000 ogłoszeń**.

- **Frazy, 150+ kategorii, miasto lub kod pocztowy z promieniem**, cena, sprzedawcy prywatni / firmy, oferty / poszukiwane, wysyłka lub odbiór, "Direkt kaufen", sortowanie.
- **Dowolny link** z filtrami (także przebieg, rok rejestracji, pokoje, metraż, pamięć, marka...), pojedyncze ogłoszenia, strony sprzedawców i sklepy PRO.
- **Bez limitu 1250 wyników** - duże wyszukiwania są dzielone na przedziały cenowe.
- **Obniżki cen** widoczne od razu w wynikach (`originalPrice`, `priceReduced`).
- **Szczegóły ogłoszenia**: pełny opis, wszystkie parametry, zdjęcia, współrzędne GPS, koszt wysyłki, sprzedawca i jego odznaki.
- **Śledzenie sprzedawców i sklepów PRO**: profil i wszystkie ogłoszenia; dla sklepów PRO nazwa firmy, telefon, adres, strona i godziny otwarcia.
- **Monitoring**: nowe ogłoszenia, **obniżki cen** oraz **sprzedane / zarezerwowane / usunięte ogłoszenia** z czasem wystawienia.

### 🇫🇷 Français

**Kleinanzeigen Scraper** récupère les annonces de **Kleinanzeigen.de**, le plus grand site de petites annonces d'Allemagne, **dès $0.90 pour 1 000 annonces** : recherche par mots-clés, catégories, ville ou code postal avec rayon, prix, vendeurs particuliers / professionnels, n'importe quel lien Kleinanzeigen, **détails complets** (description, caractéristiques, photos, GPS), **vendeurs et boutiques PRO**, **baisses de prix** et **surveillance** des nouvelles annonces, baisses de prix et annonces vendues.

### 🇪🇸 Español

**Kleinanzeigen Scraper** extrae anuncios de **Kleinanzeigen.de**, el mayor portal de anuncios clasificados de Alemania, **desde $0.90 por cada 1.000 anuncios**: palabras clave, categorías, ciudad o código postal con radio, precio, particulares / profesionales, cualquier enlace, **detalles completos** (descripción, atributos, fotos, GPS), **vendedores y tiendas PRO**, **rebajas de precio** y **monitorización** de anuncios nuevos, rebajas y anuncios vendidos.

### 🇮🇹 Italiano

**Kleinanzeigen Scraper** estrae gli annunci da **Kleinanzeigen.de**, il più grande sito di annunci della Germania, **da $0.90 ogni 1.000 annunci**: parole chiave, categorie, città o CAP con raggio, prezzo, privati / professionisti, qualsiasi link, **dettagli completi** (descrizione, caratteristiche, foto, GPS), **venditori e negozi PRO**, **ribassi di prezzo** e **monitoraggio** di nuovi annunci, ribassi e annunci venduti.

### 🇳🇱 Nederlands

**Kleinanzeigen Scraper** haalt advertenties op van **Kleinanzeigen.de**, de grootste advertentiesite van Duitsland, **vanaf $0.90 per 1.000 advertenties**: zoekwoorden, categorieën, plaats of postcode met straal, prijs, particulier / zakelijk, elke link, **volledige details** (beschrijving, kenmerken, foto's, GPS), **verkopers en PRO-winkels**, **prijsverlagingen** en **monitoring** van nieuwe, goedkopere en verkochte advertenties.

***

💬 Questions or a missing feature? Open an issue in the **Issues** tab.

# Changelog

This Actor's version history is a separate document: https://apify.com/liveclaude/kleinanzeigen-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

What to search for, e.g. <code>iphone 15</code>, <code>sofa</code>, <code>golf 7</code>. One search per line. Leave empty to scrape whole categories or locations.

## `startUrls` (type: `array`):

Paste any kleinanzeigen.de link: search or category pages with your filters (also category-specific ones like mileage, rooms or storage), single listings (<code>/s-anzeige/...</code>), seller pages (<code>s-bestandsliste.html?userId=...</code>) or PRO shops (<code>/pro/...</code>).

## `categories` (type: `array`):

Limit the search to categories. Combined with every search term. For deeper category filters (brand, mileage, rooms...) set them on kleinanzeigen.de and paste the URL above.

## `location` (type: `string`):

City, district or postcode, e.g. <code>Berlin</code>, <code>München</code>, <code>50667</code>. Empty = all of Germany.

## `radiusKm` (type: `string`):

Search radius around the location.

## `priceMin` (type: `integer`):

Minimum price in EUR.

## `priceMax` (type: `integer`):

Maximum price in EUR.

## `offerType` (type: `string`):

Offers or wanted ads.

## `sellerType` (type: `string`):

Private or commercial sellers.

## `shipping` (type: `string`):

Only listings with shipping, or pickup only.

## `buyNowOnly` (type: `boolean`):

Only listings that can be bought directly with Kleinanzeigen payment.

## `postedWithinHours` (type: `integer`):

Only listings posted in the last X hours, e.g. <code>24</code>. Search stops as soon as older listings appear (fast and cheap for daily runs).

## `excludeKeywords` (type: `array`):

Skip listings whose title or snippet contains any of these words, e.g. <code>defekt</code>, <code>suche</code>, <code>tausch</code>.

## `titleMustInclude` (type: `array`):

Keep only listings whose title contains at least one of these words.

## `onlyPriceReduced` (type: `boolean`):

Only listings where the seller lowered the price (crossed-out old price shown).

## `includeTopAds` (type: `boolean`):

Promoted listings appear on top of results. Turn off to keep only organic results.

## `sortBy` (type: `string`):

Order of results.

## `maxItemsPerSearch` (type: `integer`):

Maximum listings per search term / URL / seller. 0 = all.

## `bypassResultLimit` (type: `boolean`):

Kleinanzeigen shows max. 50 pages (1,250 listings) per search. When on, big searches are split into price ranges automatically to collect more.

## `includeDetails` (type: `boolean`):

Open every listing: full description, all attributes (brand, model, mileage, rooms...), all photos, GPS coordinates, shipping cost, seller name, type, rating badges and member since. Charged as an extra event.

## `sellers` (type: `array`):

Seller user IDs (e.g. <code>73444737</code>), seller page links or PRO shop links/names (e.g. <code>cartech</code>). Returns the seller profile (and for PRO shops: company contact, address, website, opening hours) plus all their listings.

## `includeSellerListings` (type: `boolean`):

Also return all active listings of each tracked seller.

## `includeSellerProfile` (type: `boolean`):

Adds seller name, type, followers, reply time and badges to every listing (opens the listing to find the seller). Charged per unique seller.

## `onlyNewItems` (type: `boolean`):

Remember listings between runs and return only new ones, price drops and (optionally) sold or deleted listings. Schedule the Actor to get alerts.

## `monitorId` (type: `string`):

Optional name to keep separate memories for different monitors (e.g. <code>bikes-berlin</code>). Default: derived from your searches.

## `emitOnFirstRun` (type: `boolean`):

First monitoring run returns everything found. Turn off to only save a baseline.

## `trackPriceDrops` (type: `boolean`):

Return already seen listings again when their price went down.

## `detectSoldItems` (type: `boolean`):

Checks listings that disappeared from your searches and reports them as sold, reserved or removed, with days on market.

## `priceSummary` (type: `boolean`):

Adds one record per search with min / median / average / max price, quartiles, share of negotiable, reduced and shippable listings and top locations.

## `maxConcurrency` (type: `integer`):

Parallel requests.

## `proxyConfiguration` (type: `object`):

Apify Proxy is used automatically. You can bring your own proxy URLs.

## Actor input object example

```json
{
  "searchQueries": [
    "iphone 15"
  ],
  "radiusKm": "0",
  "offerType": "all",
  "sellerType": "all",
  "shipping": "all",
  "buyNowOnly": false,
  "onlyPriceReduced": false,
  "includeTopAds": true,
  "sortBy": "newest",
  "maxItemsPerSearch": 100,
  "bypassResultLimit": true,
  "includeDetails": false,
  "includeSellerListings": true,
  "includeSellerProfile": false,
  "onlyNewItems": false,
  "emitOnFirstRun": true,
  "trackPriceDrops": true,
  "detectSoldItems": true,
  "priceSummary": false,
  "maxConcurrency": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "iphone 15"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("liveclaude/kleinanzeigen-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["iphone 15"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("liveclaude/kleinanzeigen-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "iphone 15"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call liveclaude/kleinanzeigen-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,liveclaude/kleinanzeigen-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cZy0AwuzSA95ps5Ha/builds/lXbRJNQz3biMgGmv3/openapi.json
