🛒 eBay Kleinanzeigen Scraper

Scrape Kleinanzeigen.de (formerly eBay-Kleinanzeigen) at scale — full ad details, seller info, prices, images, and commercial shop data. With smart, escalating proxy fallback and per-section output tables so your data lands exactly where you expect it.

---

✨ Why Choose Us?

Other scrapers	🛒 This actor
Only return search-results summaries	Returns full ad details (art, brand, color, size, shipping, images, seller, company)
Use a single proxy strategy	Smart 3-tier proxy ladder: direct → datacenter → residential
Dump everything into one table	5 separate output tables: Overview, Pricing, Seller, Company, Media
One-shot only	Monitoring mode for daily change detection (new / updated / delisted)
Crash → lose everything	Live save — every record is persisted as it's scraped
Guess at fields when missing	Brand & size inference from title + description when the seller didn't fill them in

---

🚀 Key Features

• 🔗 Bulk input — pass any number of search URLs or single-ad URLs
• 🌐 Smart proxy ladder — starts direct, escalates to datacenter, then residential (3 retries) on blocks. Once escalated, it sticks.
• 💾 Live persistence — every ad is pushed to the dataset as soon as it's enriched
• 📊 5 output tables per run — Overview / Pricing / Seller / Company / Media
• 👀 Monitoring mode — diff against the last run and emit only new / updated / delisted ads
• 🛡️ Anti-block resilience — fresh sessions per search page, random jitter, Chrome TLS impersonation
• 🏢 Commercial seller enrichment — full impressum (address, phone, email, opening hours) for /pro/ shops
• 🇩🇪 German-aware — handles Größe / Marke / Farbe, Buyer-Protection fee parsing, soft-block recovery

---

📥 Input

{
  "startUrls": [
    { "url": "https://www.kleinanzeigen.de/s-berlin/basecap/k0l3331" }
  ],
  "query": "basecap",
  "maxItems": 100,
  "concurrency": 10,
  "maxRetries": 3,
  "requestDelay": 2.0,
  "monitoringMode": false,
  "monitoringFields": ["price", "title", "address"],
  "proxyConfiguration": { "useApifyProxy": false }
}

Field	Type	Description
startUrls	array	List of Kleinanzeigen URLs. Each can be a search-results page (/s-…) or a single ad page (/s-anzeige/…). Required.
query	string	Optional plain keyword used to build a Germany-wide search URL when startUrls is empty.
maxItems	integer	Maximum number of ads to scrape across all start URLs. Default 100.
concurrency	integer	Max simultaneous HTTP requests. Default 10.
maxRetries	integer	Retries per request before escalating proxy tier. Default 3.
requestDelay	number	Politeness delay (s) between search-results page fetches. Random jitter is added. Default 2.0.
monitoringMode	boolean	Compare against the last run's snapshot and emit only new / updated / delisted ads. Default false.
monitoringFields	array	Which fields trigger an 'updated' diff entry. Default ["price", "title", "address"].
proxyConfiguration	object	Apify proxy config. Default = no proxy. Falls back to DATACENTER, then RESIDENTIAL on blocks.

---

📤 Output

Each record matches the original schema you'd expect from a Kleinanzeigen ad.

{
  "url": "https://www.kleinanzeigen.de/s-anzeige/tofu-maus-dad-cap-basecap-…/3413526891-156-3398",
  "id": "3413526891",
  "title": "Tofu Maus Dad Cap Basecap Organic Anti Eat Meat Club",
  "price": "25.00",
  "priceCurrency": "EUR",
  "art": "Mützen, Schals & Handschuhe",
  "brand": "AntiEatMeatClub",
  "color": "Grau",
  "size": null,
  "shippingPrice": "1.99",
  "kauferschutzPrice": "1.63",
  "address": "12043 Berlin - Neukölln",
  "date": "20.05.2026",
  "viewsCount": 22,
  "primaryImageURL": "https://img.kleinanzeigen.de/api/v1/prod-ads/…",
  "imageURLs": ["…", "…", "…"],
  "categoryURLs": ["…", "…"],
  "descriptionText": "Dad Cap mit Tofu Maus Aufschrift in Anthazit von AntiEatMeatClub…",
  "sellerName": "Jacob",
  "sellerURL": "https://kleinanzeigen.de/s-bestandsliste.html?userId=1890453",
  "sellerPhone": null,
  "sellerEmailFromDescription": null,
  "sellerPhoneFromDescription": null,
  "companyInfo": null
}

📊 Output sections

Inside Apify Console, the Output tab presents 5 pre-configured tables:

Section	What it shows
📋 Overview	The headline — title, price, brand, location, views, primary image
💰 Pricing & Shipping	Price, currency, shipping cost, buyer-protection fee
👤 Seller Info	Seller name + profile URL + extracted phone / email
🏢 Commercial Sellers	Full companyInfo for /pro/ shops only (address, hours, email, phone)
🖼️ Media & Images	Primary image + the full image gallery as an array

The default dataset contains every field; the alias datasets (overview / pricing / seller / company / media) carry slimmed projections, ideal for analytics or CSV export.

---

🚀 How to Use (Apify Console)

1. Log in at console.apify.com → Actors
2. Find this actor (🛒 eBay Kleinanzeigen Scraper) and open it
3. Paste one or more Kleinanzeigen URLs into 🔗 Kleinanzeigen URLs
4. Tweak 📦 Maximum items to control how much to scrape
5. (Optional) Keep 🌐 Proxy at default (no proxy) — the actor will escalate automatically if blocked
6. Click Start
7. Watch the live log: 🚀 / 📃 / ✅ / 🪜 emojis tell you exactly what is happening
8. Open Output when the run completes — pick a section view from the dropdown
9. Export to JSON / CSV / XLSX from the same tab

---

🤖 Use via API / MCP

Sync (waits for completion, returns dataset items):

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "startUrls": [
         { "url": "https://www.kleinanzeigen.de/s-berlin/basecap/k0l3331" }
       ],
       "maxItems": 50
     }'

Async (fire-and-forget):

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/runs?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{ "query": "basecap", "maxItems": 100 }'

MCP clients (Claude, Cursor) can call this actor via the Apify MCP server at mcp.apify.com.

---

🌐 Proxy Strategy

┌──────────┐    block      ┌────────────┐    block       ┌─────────────┐
   Request ───► │  DIRECT  │  ─────────►   │ DATACENTER │  ─────────►    │ RESIDENTIAL │ ─► 3 retries
                └──────────┘               └────────────┘                 └─────────────┘

• Default = direct. No proxy is used until the platform actually blocks us.
• On block (HTTP 403 / 429 / 5xx, captcha page, or network error), the actor escalates one tier and sticks there for the rest of the run.
• On RESIDENTIAL the actor retries each request up to 3 times before giving up.
• Every escalation is logged with 🪜 so you can audit it in the run log.

---

🎯 Best Use Cases

• 🛍️ Price monitoring for resellers
• 📈 Market research on private/used-goods categories
• 🚗 Vehicle / electronics arbitrage
• 🏘️ Real estate / rental listing tracking
• 🔁 Daily change detection (new / updated / delisted ads — use monitoringMode)

---

💸 Pricing

This actor runs on pay-per-event pricing.

Event	What it bills for
apify-actor-start	Run startup (covered by Apify for the first 5s of compute)
apify-default-dataset-item	One charge per ad pushed to the dataset

Stop the run anytime to cap your spend — partial results are already in the dataset thanks to live persistence.

---

❓ Frequently Asked Questions

Q: Will I get blocked? Probably not on small runs — the actor starts direct, jitters its delays, uses a fresh session per search-results page, and impersonates Chrome's TLS fingerprint. If Kleinanzeigen does push back, the proxy ladder kicks in automatically.

Q: Why are some fields null? Many Kleinanzeigen ads are posted by private sellers who skip the Marke / Größe / Farbe form fields. This actor falls back to inferring brand and size from the title and description, but if the cues aren't there, the field stays null rather than guessing wrong.

Q: How fast is it? ~25 ads per search page in roughly one round-trip-bound batch at concurrency=10. A 100-ad run typically completes in 1–3 minutes from direct (longer on residential).

Q: How do I scrape only new ads each day? Turn on 👀 Monitoring mode. The actor stores a snapshot in the run's key-value store and emits a changes alias dataset with _change: new | updated | delisted tags on subsequent runs.

Q: Can I scrape commercial shops in full? Yes — when an ad belongs to a /pro/<slug> shop the actor automatically fetches the shop's impressum page and fills companyInfo.companyAddress, companyPhone, companyEmails, openingHours, and companyUrl.

---

🛟 Support and Feedback

• 🐛 Issues: open an issue in the actor's Apify Console Issues tab
• 📧 Contact: scrapier.io@gmail.com
• ⭐ If this actor helped you, leave a review — it helps other scrapers find it!

---

⚖️ Cautions / Legal

• Only public ad data is collected (no private accounts, no logins).
• You are responsible for compliance with GDPR, CCPA, anti-spam laws, and Kleinanzeigen's ToS when using the scraped data.
• Honor robots.txt and reasonable rate limits — the actor's default concurrency=10 and requestDelay=2.0 are tuned to be a good citizen.