Kleinanzeigen Product Search Scraper

Overview

This actor scrapes product listings from Kleinanzeigen.de, Germany's largest classified ads platform. It extracts structured data from search results, category pages, and individual product pages for analysis, monitoring, or integration into other systems. It's useful for market research, competitor monitoring, price tracking, and academic studies.

Key Features

• High-volume scraping: Processes multiple URLs concurrently with configurable item limits.
• Proxy support: Uses Apify Proxy with residential IP rotation to avoid detection and blocking.
• Robust error handling: Includes retry logic for failed requests to maximize data collection.
• Structured output: Returns clean, standardized JSON data.
• Category flexibility: Works across all Kleinanzeigen.de categories and search filters.
• Dual input methods: Can scrape from direct URLs or by constructing searches from filters.

How to Use

Configure the actor using a JSON input. You can provide direct URLs to listing pages or define search parameters.

Input Format

The scraper accepts a JSON object with these key parameters:

{
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  },
  "max_items_per_url": 20,
  "urls": ["https://www.kleinanzeigen.de/s-wohnzimmer/seite:2/c88"],
  "ignore_url_failures": true
}

Important: If you provide URLs in the urls parameter, all search filter options are disabled. The scraper will only collect data from the specified URLs.

Alternative: Scrape with Search Filters

Instead of URLs, you can define search parameters to construct queries dynamically. This method automatically handles pagination.

Input/Output

Input Examples:
- Category page: https://www.kleinanzeigen.de/s-wohnzimmer/c88
- Paginated results: https://www.kleinanzeigen.de/s-wohnzimmer/seite:2/c88
- Filtered search: https://www.kleinanzeigen.de/s-wohnzimmer/c88+wohnzimmer.color_s:gelb

Output Data:
The scraper returns structured JSON containing:
- Product title and description
- Price and location information
- Seller details and contact options
- Category and condition
- Images and URLs
- Posting date and metadata

Proxy Configuration:
Set apifyProxyCountry to match your target data location (e.g., "DE" for Germany). Residential proxies (RESIDENTIAL) are recommended to avoid blocking.

Error Handling:
When ignore_url_failures is true, the scraper continues running even if some URLs fail after reaching the maximum retry count.

For issues or questions, contact through My profile.