Kleinanzeigen Search Scraper This Apify Actor allows you to scrape search results from Kleinanzeigen based on customizable search parameters such as postal code, category, radius, and query terms. It retrieves structured data for easy integration into workflows, automation, or data pipelines. --- ## Features - Search Kleinanzeigen by: - Postal code (plz) - Category - Radius (distance around postal code) - Query string (keywords) - Page number (for pagination) [//]: # (- Optionally filter for "Buy Now" listings (currently set to False).) - Returns structured JSON data. - Easily integrates with Apify’s storage and datasets. --- ## Input Parameters The Actor accepts the following input fields: | Field | Type | Required | Description | |------------|--------|----------|-----------------------------------------------------------------------------------| | zip | string | No | German postal code to limit the search area (Leave out or "" for no restriction). | | category | string | No | Category of items to search in (see down below on how to find the categoryId). | | query | string | No | Search keywords (Not required but strongly advised to be used). | | radius | number | No | Radius in kilometers around the postal code. | | page | number | No | Page number for pagination (default: 0). | --- ## Output The Actor pushes data into the default dataset. Each record is structured as JSON and includes the results from Kleinanzeigen based on the specified parameters. Example output (simplified): json { "page": 0, "all_pages": 3, "total_results": 62, "query": "Samsung", "results": [ { "title": "S21 FE 128 GB", "result_zip_code": "XXXX", "result_location_name": "XXXXX", "listing_time": "2025-09-04T16:XXXXXX", "category": "173", "description": "<Description>", "id": 3179XXXXX, "url_to_listing": "https://www.kleinanzeigen.de/s-anzeige/s21-fe-128-gb/3179487XXX", "pictures": [ ... ], "price": 140, "price_type": "SPECIFIED_AMOUNT", "seller_name": "", "seller_id": "", "buynow": true, "shipping": "undefined", "condition": "ok" }, ... ] } ## Output Explanation - page: The page requested by you, defaults to zero (sorted by newest listings first) - all_pages: all possible pages starting at zero - total_results: How many listings matched the search - query: Your requested Query - results: An array of the found listings. A listing consists of: - title - result_zip_code: where is the listing to be found at - result_location_name: the name of the location - listing_time: when was the listing listed - category: The categoryId see down below for more infos - description: The first part of the description. May include HTML elements. - id: the id of the listing - url_to_listing: Under what url can the listing be found - pictures: all pictures for the listing - price: the price as a whole integer. Kleinanzeigen does not support fractions anyway. - price_type: Either SPECIFIED_AMOUNT: Fixed price or PLEASE_CONTACT: it is possible to negotiate with the seller, it is marked as VB (Verhandlungsbasis) on the webiste. - seller_name: currently empty/not supported - seller_id: currently empty/not supported - buynow: boolean, wheather it is possible to use the "Sofortkaufen" Function on Kleinanzeigen for the item. - shipping: currently empty/not supported, later it should be possible to find out if the seller is willing to ship the item. - condition: What condition is the item. #### CategoryId ##### How to find the CategoryId? Go to kleinanazeigen website, pick your desired category, inspect the HTML and search for categoryId (Note the capitalization). There will be multiple results, search for the input HTML tag for example: <input type="hidden" value="195" name="categoryId" id="search-category-value"> Some example values: - Immobilien: 195 - Elektronik: 161 ## Examples ### German wide search Post this body with your query: json { "query": "Iphone", "page": 0 } ### Search with zip code no radius The following query will only search in 12345 (radius will be auto set to zero!) json { "zip": 12345, "query": "Iphone", "page": 0 } ### Search with zip code and radius The following query will only search in 12345 with 20 km Radius around it! json { "zip": 12345, "radius": 20 "query": "Iphone", "page": 0 }