eBay Kleinanzeigen Contact Scraper

TL;DR – Quick Start

1. Install the actor from Apify Store
2. Enter your search query (e.g., "Webdesigner Hamburg")
3. Set how many results you want (max 100)
4. Click Start and wait (~30s per result)
5. Download your leads in JSON, CSV, or Excel

💡 Perfect for finding businesses, services, freelancers, or clients on Kleinanzeigen.de (formerly eBay Kleinanzeigen).

---

What does this actor do?

This actor extracts listings and contact details from Kleinanzeigen.de, Germany's largest classifieds platform. It's ideal for lead generation, prospecting, market research, or recruiting services.

✨ NEW: Smart Search Features

• Auto-detection of cities: Just type "Webdesigner Hamburg" or "Hamburg Webdesigner" - the actor automatically detects the city!
• Flexible search: Works with "Frankfurt Developer", "München Grafiker", or just "Webdesigner" for nationwide search
• Enhanced contact extraction: Better email and phone detection, searches entire page (not just description)
• Multiple contacts: Saves all emails/phones found if multiple exist

---

Data Extracted

• title – cleaned ad title
• email – first email found (validated)
• phone – first phone number found (validated, cleaned)
• allEmails – array of all emails if multiple found
• allPhones – array of all phones if multiple found
• address – location / locality
• price – price of the listing
• url – direct link to the ad

---

Example Input

{
  "searchQuery": "Webdesigner Hamburg",
  "maxResults": 20
}

Supported search formats:

• "Webdesigner Hamburg" → Searches for Webdesigner in Hamburg
• "Hamburg Webdesigner" → Same result (auto-detects city)
• "Webdesigner" → Nationwide search
• "Frankfurt Developer" → Works with any major German city

---

Example Output

{
  "title": "Professional Web Design Services",
  "email": "contact@webdesign.de",
  "phone": "+4912345678",
  "allEmails": ["contact@webdesign.de", "info@example.com"],
  "allPhones": ["+4912345678", "015112345678"],
  "address": "Hamburg",
  "price": "500 €",
  "url": "https://www.kleinanzeigen.de/s-anzeige/..."
}

---

Use Cases

• Lead Generation – find potential customers for your business
• Market Research – analyze competitors and pricing
• Business Development – discover suppliers or partners
• Recruitment – find freelancers and service providers

---

Reliability Features

• Residential proxy rotation to avoid blocks
• Cookie banner handling & persistence
• Automatic retry on failed requests
• Session rotation when blocked
• Detailed logging for progress tracking

---

Notes & Tips

💡 Smart City Detection: The actor now automatically detects major German cities in your search query! Try "Webdesigner Hamburg", "Hamburg Webdesigner", or just "Webdesigner" for nationwide results.

💡 Enhanced Contact Extraction: The actor now searches the entire page for emails and phone numbers (not just the description), with improved regex patterns for better detection of German phone formats.

💡 Sometimes searches filtered by a specific city or region may not return results. This is a limitation on eBay Kleinanzeigen's side, not the actor. For best practice, try testing multiple queries or using broader terms. 🔍✨

---

Local Testing

To test the actor locally:

# Install dependencies
npm install

# Run tests for search logic and contact extraction
node test-local.js

# Run the actor locally (requires Apify account)
npm start

Edit .apify/input.json to customize your search:

{
  "searchQuery": "Webdesigner Hamburg",
  "maxResults": 5
}

---

💡 Note: This actor is designed for legitimate business purposes. Please respect the website's terms of service and use the data responsibly.