# Kleinanzeigen Scraper - Listings and Ad Details (`sourabhbgp/kleinanzeigen-scraper`) Actor Scrape Kleinanzeigen.de, Germany's largest classifieds marketplace: search listings by keyword, category, and location, and pull full ad details with price, description, images, seller, and location. Export to JSON, CSV, or Excel. - **URL**: https://apify.com/sourabhbgp/kleinanzeigen-scraper.md - **Developed by:** [Sourabh Kumar](https://apify.com/sourabhbgp) (community) - **Categories:** E-commerce, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 listing results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Kleinanzeigen scraper: search listings and full ad details Scrape Kleinanzeigen.de, Germany's biggest classifieds marketplace. Search listings by keyword, category, and location, or pull complete ad details by URL or ID: price, description, images, GPS location, seller, and structured attributes. **$2 per 1,000 listings. Flat for both modes. No monthly minimum.** Covers the whole marketplace: cars, real estate, electronics, furniture, jobs, and every other category. ### Why this scraper? - 💶 **$2 per 1,000 listings**, the same flat rate for search and detail. - ⚡ **Fast and stable.** It reads clean structured data, not guessed-at HTML, so it doesn't break every time the site reshuffles its layout. - 🚫 **No browser, no Cloudflare dance.** HTTP-only and lightweight; bot protection is handled for you with no proxy setup. - 📍 **Rich records.** Every listing carries price, description, images, ZIP, city, GPS coordinates, category, and seller. - 🖼️ **Full-resolution image URLs**, not tiny thumbnails. - 🧾 **Structured attributes** like condition, type, and size parsed into clean key-value pairs. - 🔎 **Two ways in.** Discover listings by search, or hydrate a known ad by URL or numeric ID. - 🇩🇪 **Whole of Germany**, every category, in one actor. ### What data can you extract?
🏷️ Title💶 Price + type📝 Description🗂️ Category
📍 ZIP + city🗺️ GPS coordinates🖼️ Image URLs🧾 Attributes
👤 Seller ID🏪 Store name🌟 Seller rating🔵 Private / commercial
📦 Offer / wanted🚚 Shipping↘️ Original price📅 Posted date
🔗 Ad URL🆔 Ad ID✅ Status#️⃣ Image count
### Scraping modes #### 🔎 Search listings Search by keyword, category ID, and/or location ID. Returns one row per listing with price, images, location, and attributes. Paginates automatically up to your `maxItems`. ```json { "mode": "search", "searchQuery": "iphone 15", "maxItems": 100 } ```` #### 📄 Ad details Pass ad URLs or bare numeric IDs and get the full record for each, including seller name and rating. Bad or deleted IDs come back as an error row and are never charged. ```json { "mode": "detail", "adUrls": [ "https://www.kleinanzeigen.de/s-anzeige/28-zoll-damen-fahrrad/3452864411-217-3678", "3450746525" ] } ``` ### How to scrape Kleinanzeigen: step by step 1. [Create a free Apify account](https://console.apify.com/sign-up). Takes 30 seconds, no card needed. 2. Open [Kleinanzeigen Scraper](https://console.apify.com/actors/2Gm27Xc2GYDLCQ3Rw?addFromActorId=2Gm27Xc2GYDLCQ3Rw) in the Apify Console. 3. Pick a mode and paste your search keywords or ad URLs. 4. Click **Start**. Most runs finish in seconds. 5. Export as JSON, CSV, or Excel, or pull the data through the API. ### How much does Kleinanzeigen Scraper cost? You pay **$2 per 1,000 listings**, the same for search and detail, plus a small Apify start fee per run. The Apify Free plan includes $5 in monthly credits, roughly **2,500 listings**. The $29/month Starter plan covers about **14,500 listings** a month. Compute is negligible on this actor since it never launches a browser. ### Input ```json { "mode": "search", "searchQuery": "sofa", "categoryId": "", "locationId": "", "maxItems": 200 } ``` | Field | Type | Default | Notes | |---|---|---|---| | `mode` | string | `search` | `search` or `detail`. | | `searchQuery` | string | - | Search keywords (search mode). | | `categoryId` | string | - | Restrict to a Kleinanzeigen category ID, e.g. `217` for bikes (search mode, optional). | | `locationId` | string | - | Restrict to a region/city ID (search mode, optional). | | `maxItems` | integer | `40` | Max listings to return (search mode). | | `adUrls` | array | - | Ad URLs or numeric IDs (detail mode). | ### Output **Search** returns one row per listing (seller name and rating come from detail mode): ```json { "id": "3452864722", "url": "https://www.kleinanzeigen.de/s-anzeige/fahrrad-zum-verkaufen/3452864722-217-1060", "title": "Fahrrad zum Verkaufen", "description": "28 Zoll Fahrrad. 7 Gang Nabenschaltung mit Rücktrittbremse. Alles überholt und geschmiert. Probefahrt erwünscht.", "price": 80, "currency": "EUR", "priceType": "PLEASE_CONTACT", "originalPrice": null, "adType": "OFFERED", "shippingAvailable": false, "categoryId": "217", "categoryName": "Fahrräder & Zubehör", "locationZip": "33613", "locationState": "Bielefeld (Innenstadt)", "locationLat": 52.04546, "locationLng": 8.5196295, "attributes": { "fahrraeder.art": "Damen", "fahrraeder.type": "Cityräder", "fahrraeder.condition": "Sehr Gut" }, "images": ["https://img.kleinanzeigen.de/api/v1/prod-ads/images/e9/e90ebd24-...?rule=$_57.AUTO"], "imageCount": 5, "posterType": "PRIVATE", "sellerId": "18415822", "storeName": null, "sellerName": null, "sellerRating": null, "status": "ACTIVE", "postedAt": "2026-07-07T07:53:07.000+0200" } ``` **Detail** adds the seller name and rating: ```json { "id": "3450746525", "url": "https://www.kleinanzeigen.de/s-anzeige/airdrop-edit-v4-dream-build-mountainbike-fahrrad-downhill-enduro/3450746525-217-3678", "title": "Airdrop Edit V4 Dream Build Mountainbike Fahrrad Downhill Enduro", "price": 2999, "currency": "EUR", "priceType": "PLEASE_CONTACT", "originalPrice": null, "adType": "OFFERED", "shippingAvailable": false, "categoryName": "Fahrräder & Zubehör", "locationZip": "98617", "locationState": "Meiningen", "imageCount": 9, "posterType": "PRIVATE", "sellerId": "153239965", "storeName": null, "sellerName": "Frank", "sellerRating": 1, "status": "ACTIVE", "postedAt": "2026-07-04T20:56:37.000+0200" } ``` ### Use cases - 📊 **Price research**. Track what items actually sell for across categories and regions. - 🚗 **Vehicle and property monitoring**. Watch new car or apartment listings in a location and category. - 🛒 **Reseller sourcing**. Find underpriced deals to flip, filtered by keyword and area. - 📈 **Market analysis**. Aggregate prices, categories, and posting cadence for a niche. - 🧲 **Lead generation**. Surface commercial sellers and dealers by category and region. - 🗺️ **Geographic analysis**. Map supply and pricing by ZIP and GPS coordinates. ### Limitations - **No phone or email.** Kleinanzeigen hides seller contact details behind login, so they are not in the output. - **No street address.** You get ZIP, city, and GPS coordinates, not the house number. - **Seller name and rating are detail-mode only.** Search returns listing-level data; run detail mode for the seller fields. - **Category and location filters use IDs.** Pass the numeric `categoryId` / `locationId` (for example `217` for bikes), not their names. - **Public listings only.** The actor reaches what a logged-out visitor can see. ### FAQ #### How much does Kleinanzeigen Scraper cost? Kleinanzeigen Scraper uses pay-per-result pricing. You pay **$2 for 1,000 listings**. The Apify Free plan gives you $5 in usage credits a month, enough for around 2,500 listings. If you run regularly, the $29/month Starter plan covers about 14,500 listings. No subscription lock-in. Pause whenever. #### Is it legal to scrape Kleinanzeigen? Scraping public data is generally allowed in the US and most of the EU, as long as you don't collect personal data covered by GDPR or CCPA without a lawful basis. This actor only touches publicly accessible pages, but how you use the output is on you. Apify's full breakdown: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/). #### Can I integrate Kleinanzeigen Scraper with other tools? Push results into **Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive**, and more. Apify treats every actor as a webhook source, so anything that consumes webhooks or pulls from an API works. Full list: [Apify integrations](https://docs.apify.com/platform/integrations). #### Can I use Kleinanzeigen Scraper with the Apify API? Yes. Every run is available via the Apify REST API: ```bash curl -X POST "https://api.apify.com/v2/acts/sourabhbgp~kleinanzeigen-scraper/runs?token=APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"mode": "search", "searchQuery": "iphone 15", "maxItems": 100}' ``` Docs: [Apify API reference](https://docs.apify.com/api/v2). #### Can I use Kleinanzeigen Scraper through an MCP Server? Yes. Apify ships an MCP server that exposes every actor as a tool, so Claude Desktop, Cursor, and any other MCP-capable client can call Kleinanzeigen Scraper. Setup: [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp). ### Your feedback Bug, missing field, or odd behavior? Drop a note in the [Issues tab](https://console.apify.com/actors/2Gm27Xc2GYDLCQ3Rw/issues). Reports go to a human and fixes usually ship the same week. # Actor input Schema ## `mode` (type: `string`): What to scrape. 'search' returns listings for a keyword/category/location query. 'detail' returns full ad data for the ad URLs or IDs you provide. ## `searchQuery` (type: `string`): Search mode only. Keywords to search for, e.g. 'fahrrad', 'iphone 15', 'sofa'. Leave empty to browse a category/location without a keyword. ## `categoryId` (type: `string`): Search mode only. Restrict to a Kleinanzeigen category ID (e.g. 217 = Fahrräder & Zubehör). Leave empty for all categories. ## `locationId` (type: `string`): Search mode only. Restrict to a Kleinanzeigen location ID (region/city). Leave empty for all of Germany. ## `maxItems` (type: `integer`): Search mode only. Maximum number of listings to return. Results are paginated 40 per page. ## `adUrls` (type: `array`): Detail mode only. Kleinanzeigen ad URLs (https://www.kleinanzeigen.de/s-anzeige/.../1234567890-...) or bare numeric ad IDs. ## Actor input object example ```json { "mode": "search", "searchQuery": "fahrrad", "maxItems": 20, "adUrls": [] } ``` # Actor output Schema ## `results` (type: `string`): View the scraped records in the dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "fahrrad", "maxItems": 20, "adUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("sourabhbgp/kleinanzeigen-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "fahrrad", "maxItems": 20, "adUrls": [], } # Run the Actor and wait for it to finish run = client.actor("sourabhbgp/kleinanzeigen-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "fahrrad", "maxItems": 20, "adUrls": [] }' | apify call sourabhbgp/kleinanzeigen-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sourabhbgp/kleinanzeigen-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper - Listings and Ad Details", "description": "Scrape Kleinanzeigen.de, Germany's largest classifieds marketplace: search listings by keyword, category, and location, and pull full ad details with price, description, images, seller, and location. Export to JSON, CSV, or Excel.", "version": "0.0", "x-build-id": "tDupRjIU39Bawacyf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-kleinanzeigen-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sourabhbgp~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-kleinanzeigen-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sourabhbgp~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-kleinanzeigen-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "detail" ], "type": "string", "description": "What to scrape. 'search' returns listings for a keyword/category/location query. 'detail' returns full ad data for the ad URLs or IDs you provide.", "default": "search" }, "searchQuery": { "title": "Search keywords", "type": "string", "description": "Search mode only. Keywords to search for, e.g. 'fahrrad', 'iphone 15', 'sofa'. Leave empty to browse a category/location without a keyword." }, "categoryId": { "title": "Category ID (optional)", "type": "string", "description": "Search mode only. Restrict to a Kleinanzeigen category ID (e.g. 217 = Fahrräder & Zubehör). Leave empty for all categories." }, "locationId": { "title": "Location ID (optional)", "type": "string", "description": "Search mode only. Restrict to a Kleinanzeigen location ID (region/city). Leave empty for all of Germany." }, "maxItems": { "title": "Max listings (search mode)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Search mode only. Maximum number of listings to return. Results are paginated 40 per page.", "default": 40 }, "adUrls": { "title": "Ad URLs or IDs (detail mode)", "type": "array", "description": "Detail mode only. Kleinanzeigen ad URLs (https://www.kleinanzeigen.de/s-anzeige/.../1234567890-...) or bare numeric ad IDs.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```