# Kleinanzeigen Scraper ($1.37/1K): New Ad Monitor & Deals (`tsutseisoftware/kleinanzeigen-scraper`) Actor

Scrape Kleinanzeigen.de: any search or category URL, past the 1,250-ad limit. Watch a search for new and cheaper ads with alerts to Telegram, Slack or Discord, deal score vs. similar ads, car and flat fields, full details. Unofficial.

- **URL**: https://apify.com/tsutseisoftware/kleinanzeigen-scraper.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.09 / 1,000 ads

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 & New Ad Monitor

Get classified ads from **Kleinanzeigen.de** (formerly eBay Kleinanzeigen), Germany's biggest classifieds site, as clean, ready-to-use data: title, **price as a number** (with "VB", "Zu verschenken" and the **crossed-out earlier price**), **postal code** and town, category, date, the **TOP** mark, shipping, photos and the **shop name of commercial sellers**. Car ads come with **mileage and first registration**, flats with **living area and rooms**, straight from the listing. Optionally the actor opens each ad page and adds the whole description (e-mails and phone numbers removed), **every form field of the category** (brand, model, condition, fuel, gearbox, warm rent, deposit…), the equipment list, all photos, the region and whether the seller is private or commercial.

Paste **any URL** of the website (a search, a category, a town with radius, any filters and sorting) or build the search from the inputs: words, categories, places, radius, price, private or commercial sellers, offers or wanted ads, shipping. **Searches with more than the 1,250 ads the website shows can be read in full.** Every ad gets a **deal score**: its price against the median of comparable ads, so bargains stand out.

Built for **watching Kleinanzeigen**: schedule it every hour in monitoring mode and you get, and pay for, only the ads that are **new or cheaper**, with an **alert to Telegram, Slack, Discord, WhatsApp or your webhook**. It can also report **sold (removed) ads** with their days online, re-posted ads, a **price check** ("what is an iPhone 13 128GB worth?"), each ad's **price history** and a **market report** of what sells and how fast.

**Price:** $1.37 per 1 000 ads (down to $1.09 on higher plans), below the most used Kleinanzeigen scrapers; an hourly monitor of one search ≈ **$2.30 a month** plus the new ads. No proxy, no account and no extra platform costs.

> **Deutsch:** Scraper für **Kleinanzeigen.de**: jede Such- oder Kategorie-URL, Ort mit Umkreis, Preis, privat oder gewerblich. Preis als Zahl (VB, Zu verschenken, alter Preis), PLZ und Ort, Datum, TOP, Versand, Fotos, bei Autos Kilometerstand und Erstzulassung, bei Wohnungen Wohnfläche und Zimmer; optional die ganze Beschreibung und alle Formularfelder. **Suchagent für neue und günstigere Anzeigen** mit Benachrichtigung per Telegram, Slack, Discord oder WhatsApp, **Deal-Score** gegenüber ähnlichen Anzeigen, verkaufte Anzeigen, **mehr als 1.250 Ergebnisse pro Suche**. Export nach Excel, CSV oder JSON.

### Why use this Kleinanzeigen scraper?

- **More data for less than the most used scrapers:** $1.37 per 1 000 ads with no extra platform costs; ad pages, vehicle fields and the other extras are optional and cheap.
- **Past the 1,250 limit:** the website shows at most 1,250 ads of a search; with **Read past 1,250 ads** the actor reads the whole search (for example every Golf for sale in Germany, or every flat in Berlin) and says in the status message if anything was left out.
- **A monitor that pays only for news:** a scheduled check without news costs a fraction of a cent and returns only new and cheaper ads (older ads promoted to the top again are not reported as new), with the previous price, re-posts marked, and optionally the ads that were **sold or removed** and how many days they were online.
- **Deal score on every ad, free:** comparableMedianPrice, priceVsMedianPercent and dealScore (50 = the usual price, higher = cheaper) against comparable ads of the same category.
- **Listing facts without opening the ad:** mileage and first registration of cars, living area and rooms of flats, shipping, direct buy, reduced price and the shop name of commercial sellers come from the listing at no extra cost.
- **Privacy-first:** never the name, user ID or phone number of a private seller from the seller box; e-mails, phone numbers and the names written next to them or in greetings removed from descriptions; street address only for commercial sellers.

| | This actor | Typical Kleinanzeigen scraper |
|---|---|---|
| Price per 1 000 ads | **$1.37** (with ad pages $1.46) | $1.50–1.55 for the most used ones, some plus platform costs |
| More than 1,250 ads per search | **yes** | no (split the search yourself) |
| New and cheaper ads only, alerts | **yes** (Telegram, Slack, Discord, WhatsApp, webhook) | some |
| Sold / removed ads, days online, re-posts | **yes** | no |
| Deal score, price check, price history, market report | **yes** | no |
| Mileage and first registration, area and rooms from the listing | **yes** | some |
| Seller names of private persons | **never** | often |

### What data can you get?

| Field | Example |
|---|---|
| Title, URL, ad number | Apple iPhone 13 Pro Max, 128 GB, https://www.kleinanzeigen.de/s-anzeige/…/3570529592-173-1291, 3570529592 |
| Price | 380 EUR, priceText "380 € VB", priceType `negotiable` (or `fixed`, `free`, `onRequest`, `swap`), isNegotiable true |
| Reduced price | originalPrice 420, priceReducedBy 40 (the website's crossed-out price) |
| Place | postal code 46147, Oberhausen; with ad pages the federal state (Bundesland, where the website shows it) and the map point |
| Category | categoryId 173, Smartphones, main category Elektronik |
| Date, TOP, wanted | postedAt 2026-11-13T20:35:00+01:00 (date and time for today and yesterday), isTop, isHighlight, isWanted |
| Shipping, direct buy | shippingPossible true, buyNow true; with ad pages "Versand ab 5,49 €" or "Nur Abholung" |
| Seller | sellerType `commercial` with storeName and storeUrl (shops and companies); `private` with the seller filter or ad pages |
| Cars and flats (from the listing) | mileageKm 68 795, firstRegistration 2020-02; livingAreaM2 76.76, rooms 2 |
| Photos | the first photo and the number of photos; with ad pages every photo |
| Description | the start of the description; with ad pages the whole text |
| With ad pages | attributes {"Marke": "Apple", "Zustand": "Sehr Gut"}, {"Kilometerstand": "68.795 km", "Getriebe": "Automatik"}, {"Warmmiete": "2.250 €"}; features \["Klimaanlage", "Navigationssystem"] |
| Deal score | comparableCount 12, comparableMedianPrice 420, priceVsMedianPercent −9.5, dealScore 55 |
| With **Add vehicle fields** | vehicleMake Volkswagen, vehicleModel Golf, vehicleYear 2020, vehicleMileageKm 68 795, vehiclePowerKw 110, vehiclePowerPs 150, vehicleFuel petrol, vehicleTransmission automatic, vehicleBodyType Kombi, vehicleColor, vehicleDamaged |
| With **Add item fields** | itemBrand Apple, itemModel iPhone 13 Pro Max, itemStorageGb 128, itemRamGb 6, itemBatteryPercent 76, itemCondition likeNew, itemWarranty |
| With **Add price history** | priceHistoryChanges 2, lowestPrice90d, highestPrice90d, averagePrice90d, priceVsAverage90dPercent, isLowestPrice90d, priceHistory \[{date, price}] |
| **Price check** rows (rowType `priceCheck`) | query iPhone 13 128GB, matchedAds 13, priceMedian 200, priceQ1 170, priceQ3 225, priceMin, priceMax, cheapestUrls |
| With **Monitoring** | changeType `new`, `updated`, `removed`, `reappeared`, `unchanged`; previousPrice, priceChange, priceChangePercent, firstSeenAt, removedAt, daysOnline, isRepost |

Measured on 1 400 smartphone ads (13 Nov 2026): price 100 %, postal code 100 %, date 99 %, photo 99 %, deal score 59–82 % (it depends on the search), shipping mark 71 %, reduced price 14 %, commercial sellers 13 %. Real estate listings show no date; turn on ad pages to get it.

### How to scrape Kleinanzeigen

1. Open the actor and paste a Kleinanzeigen URL (for example a search for "iphone 13" or the Autos category), or enter **Search words**, **Categories** and **Places**.
2. Set **Max ads** and, if you need them, the filters and options (ad pages, vehicle fields, monitoring).
3. Click **Start**. The ads appear in the dataset; export them to Excel, CSV or JSON, or get them through the API.
4. For a monitor, turn on **Monitoring: only new or changed ads**, add a notification channel and schedule the run (Schedules → every hour).

### Use cases

#### Alert me to every new iPhone 15 in Berlin under 600 €

```json
{
  "searchQueries": ["iphone 15"],
  "categories": ["173"],
  "locations": ["Berlin"],
  "radiusKm": 20,
  "maxPrice": 600,
  "adType": "offers",
  "onlyNewOrChanged": true,
  "monitoringKey": "iphone-berlin",
  "telegramBotToken": "123456:ABC…",
  "telegramChatId": "-1001234567890",
  "maxItems": 100
}
```

Schedule it every hour. The first run remembers the current ads; every next run returns only the new ones and the price drops, and sends them to Telegram.

#### Used cars with mileage, first registration and power

```json
{
  "startUrls": [{ "url": "https://www.kleinanzeigen.de/s-autos/golf/k0c216" }],
  "includeDetails": true,
  "includeVehicleFields": true,
  "maxItems": 200
}
```

#### Every flat for rent in Berlin, past the 1,250 limit

```json
{
  "startUrls": [{ "url": "https://www.kleinanzeigen.de/s-wohnung-mieten/berlin/c203l3331" }],
  "deepSearch": true,
  "maxItems": 10000
}
```

Living area and rooms come with every row; add **Add ad page details** for warm rent, deposit, floor and the equipment list.

#### How much is it worth? (price check)

```json
{
  "priceCheckQueries": ["iPhone 13 128GB", "PS5 Digital", "Thermomix TM6"],
  "priceCheckPages": 2
}
```

One row per item: median, quartiles, lowest and highest asking price of the matching offers and the 5 cheapest ads. Accessories, other variants of a model, wanted ads and broken items are left out.

#### Bargains only: at least 20 % under the usual price

```json
{
  "searchQueries": ["rennrad"],
  "maxPriceVsMedianPercent": -20,
  "skipWantedAds": true,
  "maxItems": 500
}
```

#### What sold this week (removed ads)

```json
{
  "startUrls": [{ "url": "https://www.kleinanzeigen.de/s-konsolen/hamburg/ps5/k0c279l9409r30" }],
  "onlyNewOrChanged": true,
  "includeRemovedAds": true,
  "includeMarketReport": true,
  "monitoringKey": "ps5-hamburg",
  "maxItems": 0
}
```

Run it daily (the whole search is read every run, so keep it under 1,250 ads, here about 470, or turn on **Read past 1,250 ads**). Ads that disappeared since the previous run come back as `removed` rows with their last price and days online, and MARKET_REPORT in the key-value store shows per category the ads on sale, the ads sold in the last 30 days, the median sold price and the median days to sell.

#### Monitoring mode explained

The first run reads the search and remembers its ads (in your Apify account, under the Monitoring key). Each next run finds the ads posted since the last check, so a check without news costs about $0.003, and returns only ads that are new or whose title or price changed. With **include removed** or the **market report** the whole search is read every run, so ads that disappeared can be reported. Re-posted ads (the same item posted again under a new number) are marked with `isRepost`, or skipped. Older ads that their seller promotes to the top again are not reported as new; a price change of a known ad is.

#### Notifications

After a run the saved ads (with Monitoring only the new, cheaper and removed ones) go to Telegram, Slack, Discord, WhatsApp or your own webhook: title, price and the previous price, place, deal score and link, never descriptions. Nothing is sent when nothing was saved, unless you turn **Notifications: only when something was saved** off.

#### Market summary (SUMMARY)

Every successful run writes SUMMARY to its key-value store, free: how many ads the website reports and how many were read and saved, TOP, wanted and commercial ads, ads by day, and price median, quartiles, minimum and maximum per category.

### How much does it cost to scrape Kleinanzeigen?

You pay only for what the run saves; there are no extra platform costs.

| Event | Price |
|---|---|
| Ad saved | **$1.37 per 1 000** (Bronze $1.29, Silver $1.19, Gold and higher $1.09) |
| Ad page read (with **Add ad page details**, and for ad URLs and ad numbers) | +$0.09 per 1 000 ads |
| Vehicle fields (with **Add vehicle fields**, vehicle ads with at least one field found) | +$0.10 per 1 000 ads |
| Item fields (with **Add item fields**, electronics ads with at least one field found) | +$0.10 per 1 000 ads |
| Read past 1,250 ads (with **Read past 1,250 ads**, every saved ad of a search the website shows only in part, except its first page) | +$0.10 per 1 000 ads |
| Price history (with **Add price history**, ads whose history goes back before the run) | +$0.30 per 1 000 ads |
| Price check (one result row per item, plus the row itself) | $0.0075 per item |
| Market report (once per run, from the run that knows sold ads) | $0.015 |
| Monitoring: listing page checked (every page a monitoring run reads) | $0.20 per 1 000 pages |
| Extra page (pages read beyond the saved ads, e.g. ads your filters left out) | $0.20 per 1 000 pages |
| Notification (a run that sent one) | $0.001 |
| Start of a run | $0.003 |

| Typical run | Price | Typical time |
|---|---|---|
| 100 ads | $0.14 | under a minute |
| 1 000 ads | $1.37 | about a minute |
| 1 000 ads with ad pages | $1.46 | about 20 minutes |
| 10 000 ads of one search (past 1,250) | $14.70 | about 8 minutes |
| Hourly monitor, a check without news | $0.003 | seconds |

With the $5 of free Apify credit each month you can get about 3 600 ads.

### Input example

```json
{
  "startUrls": [{ "url": "https://www.kleinanzeigen.de/s-iphone-13/k0" }],
  "maxItems": 20
}
```

### Output example

```json
{
  "id": "kleinanzeigen:3570529592",
  "rowType": "ad",
  "source": "kleinanzeigen.de",
  "url": "https://www.kleinanzeigen.de/s-anzeige/apple-iphone-13-pro-max-128-gb-mit-zubehoer-top-zustand/3570529592-173-1291",
  "adId": "3570529592",
  "title": "Apple iPhone 13 Pro Max, 128 GB- mit Zubehör- Top Zustand",
  "description": "Apple iPhone 13 Pro Max 128 GB Gold – Top Zustand + 2 m Ladekabel, 2 Hüllen & 3 Panzerfolien…",
  "price": 380,
  "currency": "EUR",
  "priceText": "380 € VB",
  "priceType": "negotiable",
  "isNegotiable": true,
  "originalPrice": null,
  "postalCode": "46147",
  "location": "Oberhausen",
  "region": "Nordrhein-Westfalen",
  "latitude": 51.54,
  "longitude": 6.82,
  "categoryId": 173,
  "category": "Smartphones",
  "mainCategory": "Elektronik",
  "postedAt": "2026-11-13T20:35:00+01:00",
  "isTop": false,
  "isWanted": false,
  "shippingPossible": false,
  "shipping": "Nur Abholung",
  "sellerType": "private",
  "storeName": null,
  "imageCount": 12,
  "attributes": { "Marke": "Apple", "Modell": "iPhone 13 Pro Max", "Speicher (GB)": "128 GB", "Zustand": "Sehr Gut" },
  "detailScraped": true,
  "comparableCount": 14,
  "comparableMedianPrice": 420,
  "priceVsMedianPercent": -9.5,
  "dealScore": 55,
  "scrapedAt": "2026-11-13T20:40:00Z"
}
```

### Good to know

- **The 1,250 limit:** the website shows at most 1,250 ads of one search. Without **Read past 1,250 ads** a bigger search stops there and the status message says so. With it, ads without an amount ("VB" only) are found only among the first 1,250.
- **Deal score** compares an ad with comparable ads of the same category (the same item, not its accessories) that the run, or the earlier runs of the same Monitoring key, has seen. A score needs a few comparable ads, so it works best with bigger searches; otherwise it is null.
- **Vehicle fields** come from the form fields of the ad page when it is read, and otherwise from the listing and the text, so they are most complete with **Add ad page details**.
- **Dates:** the website shows the time for ads of today and yesterday, otherwise the date; TOP ads and real estate listings show none.
- A page the website rejects is retried once a little later, never from another IP address; if rejections continue, the run stops with what it has saved and says so.
- **Ad URLs:** when the website rejects an ad's page, the ad is found in the website's search and saved with its listing data (ad numbers alone cannot be searched). An ad is reported as not found only when the website says it was deleted.

### For AI agents and API users

Run it from the Apify API, the Apify MCP server, Make, Zapier or n8n. **Compact output** keeps the core fields (id, title, price, place, category, date, seller type, deal score, link, monitoring, vehicle and item fields); **Leave out empty fields** drops nulls. Every field is described in the dataset schema (Output tab).

### Troubleshooting

- **"No supported URL"**: paste an address of kleinanzeigen.de: a search or category (`https://www.kleinanzeigen.de/s-…`) or an ad (`…/s-anzeige/<name>/<number>-<category>-<place>`), or put ad numbers into **Ad numbers**.
- **"Place … was not found"**: use a 5-digit postal code or the name of a German town (10115, Berlin, München).
- **"is rejecting requests"**: run without a proxy (the default) and try again later.
- **Fewer ads than the website shows**: check **Max ads**, **Max pages per search**, the filters and **Read past 1,250 ads**; the status message says what stopped the run.
- **Monitoring returned nothing**: nothing new since the last run with the same Monitoring key.

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### More classified-ad scrapers

The same deal score, monitoring and alerts for another classified-ad site:

- [Bazoš Scraper & New Ad Monitor](https://apify.com/tsutseisoftware/bazos-scraper): Bazoš.cz, .sk, .pl and .at: any section or search, deal score, car fields, new and cheaper ads with alerts
- [Facebook Marketplace Scraper](https://apify.com/tsutseisoftware/facebook-marketplace-scraper): any town, ZIP code or coordinates with a strict radius: price, place, seller, deal score, sold listings, alerts
- [Vinted Scraper](https://apify.com/tsutseisoftware/vinted-scraper): 24 Vinted country sites in one run: price, brand, size, condition in English, deal score, sold items, alerts
- [AutoScout24 Scraper](https://apify.com/tsutseisoftware/autoscout24-scraper): used and new cars from all 8 AutoScout24 countries: price rating, deal score, full specs, dealer stocks, sold listings, alerts
- [Craigslist Scraper](https://apify.com/tsutseisoftware/craigslist-scraper): any Craigslist site, a whole state or country in one run: up to 10,000 ads per search, deal score, removed ads, new ad alerts

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape Kleinanzeigen?

It reads only publicly available data, without logging in, at most 60 requests per minute, slows down when the website asks, never changes IP address to get around a limit and never solves captchas or other challenges. It does not collect the names, user IDs or phone numbers of private sellers and removes contacts, and the names written next to them, from descriptions; free text can still contain a name a seller wrote elsewhere. You are responsible for how you use the data (e.g. GDPR if you process anything personal, and the website's terms). This is an unofficial tool, not connected with Kleinanzeigen or eBay.

#### How is it different from other Kleinanzeigen scrapers?

It costs less than the most used Kleinanzeigen scrapers, it reads searches past the website's 1,250-ad limit, its monitor returns only new and cheaper ads (and, if you want, the sold ones with their days online), and every ad gets a deal score. Price check, price history, market report and normalized vehicle and electronics fields come in the same actor.

#### Do I need a proxy?

No proxy needed.

#### How often should I run the monitor?

Every 15–60 minutes for a popular search, daily for a quiet one. A check without news costs about $0.003.

#### Can I get the seller's name or phone number?

Not of private sellers: we do not collect their personal data. Commercial sellers come with their shop or company name.

#### Why are some vehicle or item fields empty?

The seller didn't fill them in or write them clearly. Turn on **Add ad page details** to use the form fields and the whole description.

This actor is also known as a Kleinanzeigen API, eBay Kleinanzeigen scraper, "Kleinanzeigen Suchagent", "Kleinanzeigen Preisalarm" or "Kleinanzeigen Crawler".

# Changelog

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

# Actor input Schema

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

Any listing of kleinanzeigen.de: a search (https://www.kleinanzeigen.de/s-iphone-13/k0), a category (https://www.kleinanzeigen.de/s-autos/c216), a place with radius, or a search with the website's filters and sorting (set them on the website and paste the address of the results). Also ad URLs (https://www.kleinanzeigen.de/s-anzeige/<name>/<number>-<category>-<place>): an ad URL is read with its whole description and form fields and charged as an ad with "Ad page read". A listing is always read from its first page.

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

Words to search, e.g. "iphone 15", "golf 7", "e-bike", "2-zimmer-wohnung". Each is a separate search (in every category and place chosen below). Leave empty to read whole categories.

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

Categories to search or read. Empty = all categories.

## `locations` (type: `array`):

Postal codes or German towns to search around, e.g. "10115", "Hamburg", "München". Each is a separate search. Empty = all of Germany.

## `radiusKm` (type: `integer`):

With "Places": how far around the place. The website offers 5, 10, 20, 30, 50, 100, 150 and 200 km (another number is rounded to the nearest of them). 0 = only the place.

## `minPrice` (type: `integer`):

The website's price filter in euros. Ads without an amount (only "VB") are left out by the website when a price is set.

## `maxPrice` (type: `integer`):

The website's price filter in euros.

## `adType` (type: `string`):

Offers of sellers, ads of buyers who look for something, or both.

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

The website's seller filter. With it, every row has its sellerType.

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

The website's shipping filter.

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

Only ads that can be bought directly with the website's payment and shipping.

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

The order of the searches built from the inputs above (pasted URLs keep their own order).

## `adIds` (type: `array`):

Numbers of ads (Anzeigen-ID, e.g. 3570529592) to read with their whole ad page; charged like ad URLs.

## `maxItems` (type: `integer`):

Maximum number of ads saved. You pay per saved ad. 0 = no limit.

## `maxPages` (type: `integer`):

Read at most this many pages (25 ads each) of every search. 0 = no limit.

## `deepSearch` (type: `boolean`):

The website shows at most 1,250 ads of one search. On: a bigger search is read in full, so you can get all its ads (only when "Max ads" asks for more than 1,250; ads without an amount, only "VB", are then found only among the first 1,250). Charged as "Read past 1,250 ads" per saved ad of such a search except its first page (see the Pricing tab). Off: every search stops at 1,250 ads.

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

Open each ad page to add its whole description (e-mails and phone numbers removed), the form fields of the category (brand, model, condition, mileage, fuel, rooms, extra costs…) as attributes, the equipment list, every photo, the region, shipping, the map point and whether the seller is private or commercial. Extra charge "Ad page read" per saved ad whose page was read (see the Pricing tab). Off: data of the listing pages (title, start of the description, price, place, date, photo, TOP, shipping, mileage and first registration of cars, living area and rooms of flats).

## `includeVehicleFields` (type: `boolean`):

For ads of cars, motorbikes, caravans and commercial vehicles: make, model, year and first registration, mileage, power (kW and PS), engine size, fuel, gearbox, body type, colour and damage, normalized from the form fields of the ad page (with "Add ad page details") or else from the listing and the text. Charged as "Vehicle fields" per saved ad with at least one field found (see the Pricing tab).

## `includeItemFields` (type: `boolean`):

For ads of electronics: brand, model, storage (GB), RAM, battery health (%), condition (new, like new, used, for parts) and warranty, from the form fields of the ad page (with "Add ad page details") and the text. Charged as "Item fields" per saved ad with at least one field found (see the Pricing tab).

## `includePriceHistory` (type: `boolean`):

Every run remembers the prices it saw (in a key-value store of your account, per Monitoring key), and every ad gets its price history: changes, lowest and highest price of 30 and 90 days, average, whether the price is the lowest in 90 days, and the list of changes. The history starts with your first run; schedule the same search. With monitoring turn "read only new ads" off to see the prices of older ads too. Charged as "Price history" per saved ad whose history goes back before the run (see the Pricing tab).

## `includeDealScore` (type: `boolean`):

Compare the price of every ad with the median price of comparable ads of the same category (same item, not its accessories): comparableCount, comparableMedianPrice, priceVsMedianPercent and dealScore (0-100, 50 = the usual price, higher = cheaper). Free. A score needs a few comparable ads, so it works best with bigger searches.

## `titleKeywords` (type: `array`):

Keep only ads whose title contains at least one of these texts (case and umlauts don't matter).

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

Skip ads whose title or description contains any of these texts, e.g. "defekt", "Bastler", "Hülle".

## `skipTopAds` (type: `boolean`):

Skip ads promoted with the website's paid TOP mark (they stay on top of the listing).

## `skipWantedAds` (type: `boolean`):

Skip ads of people who buy instead of selling ("Gesuch", "Suche…", "Kaufe…", "Ankauf…"). Every row has isWanted either way.

## `onlyWithPrice` (type: `boolean`):

Skip ads without an amount as their price ("VB" only, "Zu verschenken").

## `onlyWithPhotos` (type: `boolean`):

Skip ads without a photo.

## `postedWithinDays` (type: `integer`):

Only ads posted or renewed in the last N days. A search sorted by newest is read only until the older ads begin. Real estate listings show no date, so their ads are left out by this filter unless "Add ad page details" is on. 0 = any time.

## `minDealScore` (type: `integer`):

Keep only ads with at least this deal score (e.g. 60 = about 20 % below the median of comparable ads). Ads without enough comparable ads are left out.

## `maxPriceVsMedianPercent` (type: `integer`):

Keep only ads whose price is at most this many percent above (or, negative, below) the median of comparable ads, e.g. -15. Ads without enough comparable ads are left out.

## `priceCheckQueries` (type: `array`):

Items to price, e.g. "iPhone 13 128GB", "PS5 digital", "Golf 7 Variant". An ad matches when its title has every word of the item and no accessory words (Hülle, Case, Panzerglas…). Asking prices of current ads, not prices of sales.

## `priceCheckPages` (type: `integer`):

Listing pages (25 ads each) read for every item. More pages = more ads in the statistics.

## `onlyNewOrChanged` (type: `boolean`):

Return only ads that are new or whose title or price changed since the previous run with the same Monitoring key (changed ads have previousPrice, priceChange and priceChangePercent). Every listing page read in this mode is charged as "Monitoring: listing page checked" (see the Pricing tab; one page = 25 ads).

## `monitoringKey` (type: `string`):

Name of the saved state. Use a different key for each watched search (e.g. "iphone-berlin"). Empty = a key derived from the searches and ad URLs of the run, so different searches never share a state. The value is stored encrypted.

## `stopAtKnownAds` (type: `boolean`):

After the first run, a check finds the ads posted since the previous check and stops at the ads it already knows, so a check without news costs a fraction of a cent. Older ads promoted to the top again are not reported as new. The first run reads the search as usual. Off = read the whole search every run (finds price changes of older ads too). Turned off by "include removed", "include unchanged" and "market report".

## `includeRemovedAds` (type: `boolean`):

Also return ads of the previous run that are no longer in the search (sold or deleted), as rows with changeType "removed" (and "reappeared" when they come back), with daysOnline. Needs the whole search read every run; checked only when the run read every search completely. Charged like any other ad.

## `includeUnchanged` (type: `boolean`):

Also return the ads that did not change, as rows with changeType "unchanged" (charged like any other ad).

## `skipReposts` (type: `boolean`):

Do not return a new ad when the seller posted an ad of an earlier run again under another number. Off = such ads are returned with isRepost true and repostOf.

## `includeMarketReport` (type: `boolean`):

With monitoring: every run writes MARKET_REPORT to the key-value store: per category the ads on sale and their median price, the ads that disappeared in the last 30 days (sold, or deleted by the seller) with their median last price, median days to sell, share sold within 7 days and the sell-through rate. It learns from the ads that disappear between your runs, so it reads the whole search every run (like "include removed") and gets better with every run. Charged once per run as "Market report" (see the Pricing tab).

## `slackWebhookUrl` (type: `string`):

Incoming webhook of your Slack channel (https://hooks.slack.com/services/...). Stored encrypted.

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `telegramBotToken` (type: `string`):

Token of your Telegram bot (from @BotFather). Used with "Telegram chat ID". Stored encrypted.

## `telegramChatId` (type: `string`):

Chat, group or channel ID the bot writes to (e.g. -1001234567890).

## `webhookUrl` (type: `string`):

Any HTTPS URL (Zapier, Make, n8n, your server): gets a POST with JSON {title, summary, totalSaved, runUrl, datasetUrl, items}.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `notificationLimit` (type: `integer`):

How many ads are listed in one notification (the rest as "…and N more").

## `notifyOnlyChanges` (type: `boolean`):

Send nothing when the run saved no ad (e.g. a monitoring run without new ads).

## `compact` (type: `boolean`):

Keep only the core fields of every row: id, title, price, place, category, date, TOP, seller type, photo, deal score, link (and the monitoring, vehicle and item fields).

## `excludeEmptyFields` (type: `boolean`):

Drop fields that are null or an empty list from every row (id, source, url, adId, title and scrapedAt always stay).

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

No proxy needed. Turn a proxy on only if the website starts rejecting requests.

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.kleinanzeigen.de/s-iphone-13/k0"
    }
  ],
  "radiusKm": 0,
  "adType": "all",
  "sellerType": "all",
  "shipping": "all",
  "buyNowOnly": false,
  "sortBy": "newest",
  "maxItems": 20,
  "maxPages": 0,
  "deepSearch": false,
  "includeDetails": false,
  "includeVehicleFields": false,
  "includeItemFields": false,
  "includePriceHistory": false,
  "includeDealScore": true,
  "skipTopAds": false,
  "skipWantedAds": false,
  "onlyWithPrice": false,
  "onlyWithPhotos": false,
  "priceCheckPages": 2,
  "onlyNewOrChanged": false,
  "stopAtKnownAds": true,
  "includeRemovedAds": false,
  "includeUnchanged": false,
  "skipReposts": false,
  "includeMarketReport": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "compact": false,
  "excludeEmptyFields": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "sendErrorReports": true
}
```

# Actor output Schema

## `ads` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `marketReport` (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 = {
    "startUrls": [
        {
            "url": "https://www.kleinanzeigen.de/s-iphone-13/k0"
        }
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/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 = {
    "startUrls": [{ "url": "https://www.kleinanzeigen.de/s-iphone-13/k0" }],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/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 '{
  "startUrls": [
    {
      "url": "https://www.kleinanzeigen.de/s-iphone-13/k0"
    }
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call tsutseisoftware/kleinanzeigen-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/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/jfI78HTvg26dh82GP/builds/JTxWlGAQbGIAZpDQs/openapi.json
