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

Note: 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 any city/ZIP: We call Kleinanzeigen’s official /s-ort-empfehlungen.json endpoint to resolve the right location ID & slug even for villages or Kreise.
• Radius + category filters: Use the radiusKm and categoryId inputs to restrict results to a service radius or specific marketplace category.
• Keyword relevance filter: Each ad is re-checked to ensure the title/description actually contains the requested keywords—no more random matches.
• Synonym-aware matching: Built-in dictionary covers variations like “webdesign”, “homepage”, “website”, “webagentur”, so relevant listings aren’t skipped due to different wording.
• 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
• definition – structured attributes captured when the site shows “Definition” blocks
• url – direct link to the ad

Example Input

{
  "searchQuery": "Webdesigner Hamburg",
  "radiusKm": 30,
  "categoryId": 102,
  "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

Optional fields

• city – force a specific city/ZIP if you don’t want auto-detection
• radiusKm – limit results around the detected city (1–200 km)
• categoryId – pass a Kleinanzeigen category (e.g. 102 for Dienstleistungen)

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 €",
  "definition": "Kategorie: Dienstleistungen\nTyp: Angebot",
  "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

Tip: We resolve every query through Kleinanzeigen’s /s-ort-empfehlungen.json service, so even smaller Gemeinden or PLZ combos get the correct lXXXX id automatically.

Tip: 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.

Tip: Pass radiusKm to keep the crawl inside your service area, and categoryId to focus on Dienstleistungen, Jobs, Immobilien etc.—fewer irrelevant pages, lower run costs.

Tip: 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",
  "radiusKm": 20,
  "categoryId": 102,
  "maxResults": 5
}

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