Kleinanzeigen Scraper

The specialized scraper for Kleinanzeigen.de. Extract detailed listings including prices, photos, descriptions, and locations from Germany's largest classifieds market.

🚀 Why this scraper?

Most Kleinanzeigen scrapers require manual filtering or struggle with the strict anti-bot protection. This actor is optimized for stability.

Kleinanzeigen Scraper acts like a real user:

1. You provide a Search Keyword (e.g., "Fahrrad").
2. The actor navigates, searches, handles pagination, and extracts clean data using JSON-LD metadata for highest quality.

Perfect for:

• 📉 Price Monitoring: Track market prices for used goods.
• 🏠 Real Estate: Find new apartment listings ("Wohnung mieten").
• 🚗 Automotive: Monitor car prices.
• 🛍️ Arbitrage: Find undervalued items.

---

📖 How to Use

Option 1: Apify Console (No Coding)

1. Go to the Input tab.
2. Enter your Search Keyword (e.g., PlayStation 5).
3. Proxy Selection: Select "Apify Proxy" (Residential Germany is highly recommended) OR select your own custom proxy groups.
4. Click Start.
5. Download your data in Excel, CSV, or JSON format.

Option 2: API (Developers)

You can trigger this actor programmatically via REST API, Python, or Node.js.

Input Payload (JSON)

{
    "searchQuery": "iPhone 13 mini",
    "maxPages": 1,
    "maxRequestsPerCrawl": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE"
    }
}

🐍 Python Example (Simple & Clean)

import json
from apify_client import ApifyClient

# 1. Configuration
APIFY_TOKEN = 'YOUR_APIFY_TOKEN'
ACTOR_ID = 'daddyapi/kleinanzeigen-scraper'

client = ApifyClient(APIFY_TOKEN)

# 2. Define Input
run_input = {
    "searchQuery": "MacBook Pro M1",
    "maxPages": 1,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE"
    }
}

print(f"🚀 Starting scraper for: {run_input['searchQuery']}...")

# 3. Run Actor
run = client.actor(ACTOR_ID).call(run_input=run_input)

if not run:
    print("❌ Failed to start run.")
    exit(1)

print(f"✅ Run finished! Status: {run['status']}")

# 4. Fetch & Save Results
dataset_client = client.dataset(run["defaultDatasetId"])
items = dataset_client.list_items().items

filename = "results.json"
with open(filename, "w", encoding="utf-8") as f:
    json.dump(items, f, indent=2, ensure_ascii=False)

print(f"💾 Saved {len(items)} listings to {filename}")

---

🔒 Proxy Configuration (Bring Your Own Proxies)

This actor is fully compatible with Apify Proxy (Datacenter & Residential) and Custom Proxies.

1. Residential Proxies (Germany)

Highly Recommended. Kleinanzeigen has very strict bot detection. Residential proxies from Germany provide the best success rate.

{
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE"
    }
}

2. Custom Proxies

If you have proxies from an external provider (BrightData, Smartproxy, etc.), pass the connection strings directly.

{
    "proxyConfiguration": {
        "useApifyProxy": false,
        "proxyUrls": [
            "http://username:password@my-proxy.example.com:8000"
        ]
    }
}

---

📊 Data Output

The scraper returns highly detailed, structured data for every listing:

{
  "type": "search_result_kleinanzeigen",
  "id": "3295415791",
  "url": "https://www.kleinanzeigen.de/s-anzeige/homerecording-set-focusrite-sennheiser-t-bone/3295415791-172-2023",
  "title": "Homerecording Set: Focusrite + Sennheiser + t.bone",
  "description": "Ich verkaufe hier mein zuverlässiges Homerecording-Einsteiger-Set. Alle Komponenten funktionieren einwandfrei und sind ideal für Podcasts...",
  "price": {
    "amount": 135,
    "currency": "EUR",
    "display": "135 € VB"
  },
  "location": {
    "city": "Hamm",
    "address": "59071 Hamm"
  },
  "mainPhoto": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/0b/0b44d382-292f-491a-9d33-294f7eeb21b5?rule=$_59.AUTO",
  "photos": [
    "https://img.kleinanzeigen.de/api/v1/prod-ads/images/0b/0b44d382-292f-491a-9d33-294f7eeb21b5?rule=$_59.AUTO"
  ],
  "postedAt": "Heute, 22:33",
  "isBusiness": false,
  "seller": null
}

---

⚙️ Configuration Parameters

Parameter	Type	Required	Default	Description
searchQuery	String	✅	-	What to search for.
maxPages	Integer	❌	1	Depth of scrape. 1 page ≈ 25 listings.
proxyConfiguration	Object	❌	Auto	Configure Residential (DE) or Your Custom Proxy Groups.

---

🛡️ Troubleshooting

• Access Denied / 403? Kleinanzeigen detected the request. Ensure you are using German Residential Proxies.
• Empty Results? Try a broader keyword or check spelling (e.g., "Handy" instead of "Phone").

---

⚖️ Legal & Ethics

This scraper is for educational and analytical purposes. Please respect Kleinanzeigen's Terms of Service and robots.txt. Do not use this tool to spam sellers or overload their servers. Use responsible rate limits.

---

🌟 More Scrapers from DaddyAPI

Check out our other specialized tools for scraping data:

Scraper	Description	Price
Generic Html Scraper	[Participating in the $1M Challenge] A lightweight, robust, and simple actor to fetch the raw HTML content of any URL.	Pay per result
Avito Scraper	Scrape ads from avito.ru. Extracts prices, photos, descriptions, and seller info.	Pay per result
Leboncoin Scraper	Scrape ads from leboncoin.fr. Extracts detailed listings.	Pay per result
Olx Brazil Scraper	Dedicated scraper for olx.com.br. Optimized for Brazil.	Pay per result
Olx India Scraper	Dedicated scraper for olx.in. Optimized for India.	Pay per result
Olx Search Scraper	Global OLX scraper. Supports Ukraine, Poland, Romania, Portugal, and more.	Pay per result
Marktplaats Scraper	Scrape ads from the Dutch marketplace marktplaats.nl.	Private
Poshmark Scraper	Scrape fashion listings from Poshmark.	Private
Reddit Scraper	Extract posts and comments from Reddit.	Pay per result