{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Cars Scraper: Autos, Gebrauchtwagen & Price Drops", "description": "Scrape Kleinanzeigen Autos and Gebrauchtwagen with filters for make, price, mileage, year, fuel and seller type. Get specs, dealer signals and photos, plus a monitor that returns only new cars and price drops since your last run. Export to Sheets, Excel or n8n.", "version": "0.3", "x-build-id": "8rf8Ik7FFZKM68TAo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~kleinanzeigen-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-kleinanzeigen-cars-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/getascraper~kleinanzeigen-cars-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-kleinanzeigen-cars-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/getascraper~kleinanzeigen-cars-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-kleinanzeigen-cars-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", "properties": { "searchMode": { "title": "How do you want to search?", "enum": [ "guided", "urls" ], "type": "string", "description": "Build a Kleinanzeigen autos search with the filters below, or use pasted Kleinanzeigen URLs without changes.", "default": "guided" }, "startUrls": { "title": "Kleinanzeigen search or listing URLs", "type": "array", "description": "Used only when search mode is set to pasted URLs. These public URLs are crawled unchanged.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "A public Kleinanzeigen autos search or listing URL." } } }, "default": [] }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional words found in the listing title or description, such as trim, model variant, or equipment.", "default": "" }, "make": { "title": "Make", "type": "string", "description": "Vehicle make. Common Kleinanzeigen makes are suggested and custom source values are accepted.", "default": "" }, "model": { "title": "Model or model variant", "type": "string", "description": "Optional model text, kept as a Kleinanzeigen keyword constraint so uncommon variants are not silently dropped.", "default": "" }, "location": { "title": "City or postcode", "type": "string", "description": "Kleinanzeigen resolves this to an exact location before the search starts. Use the city name or German postcode.", "default": "" }, "radiusKm": { "title": "Search radius", "minimum": 0, "maximum": 200, "type": "integer", "description": "Distance around the selected city or postcode. Use a Kleinanzeigen-supported value: 0, 1, 2, 3, 5, 10, 15, 20, 30, 50, 100, 150, or 200.", "default": 0 }, "minPriceEur": { "title": "Minimum price", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Lowest asking price in euros.", "default": 0 }, "maxPriceEur": { "title": "Maximum price", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Highest asking price in euros.", "default": 10000000 }, "minMileageKm": { "title": "Minimum mileage", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Lowest mileage in kilometres.", "default": 0 }, "maxMileageKm": { "title": "Maximum mileage", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Highest mileage in kilometres.", "default": 2000000 }, "minFirstRegistrationYear": { "title": "First registration from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest first-registration year.", "default": 1900 }, "maxFirstRegistrationYear": { "title": "First registration to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest first-registration year.", "default": 2100 }, "minPowerKw": { "title": "Minimum power", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Lowest engine power in kilowatts.", "default": 1 }, "maxPowerKw": { "title": "Maximum power", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Highest engine power in kilowatts.", "default": 2000 }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "One or more fuel types available on Kleinanzeigen.", "items": { "type": "string", "enum": [ "benzin", "diesel", "cng", "lpg", "hybrid", "elektro", "andere" ], "enumTitles": [ "Petrol", "Diesel", "CNG", "LPG", "Hybrid", "Electric", "Other" ] }, "default": [] }, "transmissions": { "title": "Transmission", "type": "array", "description": "Automatic, manual, or both.", "items": { "type": "string", "enum": [ "automatik", "manuell" ], "enumTitles": [ "Automatic", "Manual" ] }, "default": [] }, "bodyTypes": { "title": "Body type", "type": "array", "description": "One or more vehicle body styles.", "items": { "type": "string", "enum": [ "kleinwagen", "limousine", "kombi", "cabrio", "suv", "bus", "coupe", "andere" ], "enumTitles": [ "Small car", "Saloon", "Estate", "Convertible", "SUV or off-road", "Van or bus", "Coupé", "Other" ] }, "default": [] }, "damageStatus": { "title": "Vehicle damage", "enum": [ "", "with_damage", "without_damage" ], "type": "string", "description": "Limit results to damaged or undamaged vehicles.", "default": "" }, "doorCounts": { "title": "Number of doors", "type": "array", "description": "One or more Kleinanzeigen door-count bands.", "items": { "type": "string", "enum": [ "2_3", "4_5", "6_7", "andere" ], "enumTitles": [ "2 or 3", "4 or 5", "6 or 7", "Other" ] }, "default": [] }, "colors": { "title": "Colour", "type": "array", "description": "One or more exterior colours.", "items": { "type": "string", "enum": [ "beige", "blau", "braun", "gelb", "gold", "grau", "grün", "orange", "rot", "schwarz", "silber", "violet", "weiß", "sonstige" ], "enumTitles": [ "Beige", "Blue", "Brown", "Yellow", "Gold", "Grey", "Green", "Orange", "Red", "Black", "Silver", "Violet", "White", "Other" ] }, "default": [] }, "emissionClasses": { "title": "Emission class", "type": "array", "description": "One or more source emission classes.", "items": { "type": "string", "enum": [ "euro1", "euro2", "euro3", "euro4", "euro5", "euro6" ], "enumTitles": [ "Euro 1", "Euro 2", "Euro 3", "Euro 4", "Euro 5", "Euro 6" ] }, "default": [] }, "environmentBadges": { "title": "Environmental badge", "type": "array", "description": "One or more German environmental badge categories.", "items": { "type": "string", "enum": [ "4_gruen", "3_yellow", "2_red", "1_none" ], "enumTitles": [ "4 green", "3 yellow", "2 red", "1 none" ] }, "default": [] }, "interiorMaterials": { "title": "Interior material", "type": "array", "description": "One or more source interior-material values.", "items": { "type": "string", "enum": [ "volleder", "teilleder", "stoff", "velours", "alcantara", "andere" ], "enumTitles": [ "Full leather", "Part leather", "Fabric", "Velour", "Alcantara", "Other" ] }, "default": [] }, "minTuVYear": { "title": "TÜV valid from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest TÜV year required by the source filter.", "default": 1900 }, "sellerType": { "title": "Seller type", "enum": [ "", "private", "commercial" ], "type": "string", "description": "Choose private listings or commercial dealer listings.", "default": "" }, "listingIntent": { "title": "Listing type", "enum": [ "", "offers", "requests" ], "type": "string", "description": "Choose listings that offer a vehicle or requests from buyers.", "default": "" }, "features": { "title": "Required equipment", "type": "array", "description": "Require one or more source-supported equipment features.", "items": { "type": "string", "enum": [ "autos.air_conditioning_b", "autos.navi_b", "autos.park_assistant_b", "autos.bluetooth_b", "autos.trailer_coupling_b", "autos.seat_heating_b", "autos.speed_control_b", "autos.full_service_history_b", "autos.abs_b", "autos.alluminium_rims_b", "autos.xenon_led_light_b", "autos.radio_tuner_b", "autos.handsfree_speaker_b", "autos.sunroof_b", "autos.non_smoking_b" ], "enumTitles": [ "Air conditioning", "Navigation", "Parking assist", "Bluetooth", "Tow hitch", "Seat heating", "Cruise control", "Full service history", "ABS", "Alloy wheels", "Xenon or LED lights", "Radio or tuner", "Hands-free speaker", "Sunroof", "Non-smoker vehicle" ] }, "default": [] }, "sortBy": { "title": "Sort results by", "enum": [ "recommended", "newest", "lowest_price", "highest_price" ], "type": "string", "description": "Ordering used by the Kleinanzeigen search results.", "default": "recommended" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings. Kleinanzeigen is tested with direct public requests, so leave this empty unless your run needs a different network route.", "default": {} }, "scrapeDetails": { "title": "Enrich with listing details", "type": "boolean", "description": "Open individual listings to add detailed specifications, complete image galleries, public seller signals, and source attributes.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give this search a name to remember it between runs. The next run with the same name returns only new cars and price changes, flagged with monitor_status and price_drop. Leave empty for a normal one-off run.", "default": "" }, "onlyChanges": { "title": "Only new and changed cars", "type": "boolean", "description": "With a monitor name, skip cars that are unchanged since the last run so you pay only for new cars and price changes. Turn off to receive every car with its status.", "default": true }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 2500, "type": "integer", "description": "Maximum number of vehicle listings saved to the dataset. Kleinanzeigen shows at most 50 result pages (about 1,250 cars) per search, so use filters or several searches for more.", "default": 10 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of result pages read for each search URL. Each page holds about 25 cars and Kleinanzeigen serves up to 50 pages.", "default": 2 }, "maxDetailPages": { "title": "Maximum detail pages", "minimum": 0, "maximum": 2500, "type": "integer", "description": "Maximum number of individual listings opened when detail enrichment is enabled. Remaining listings are saved from the search results.", "default": 10 }, "maxConcurrency": { "title": "Maximum concurrent requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Advanced network setting. Lower values are gentler on the source and higher values may finish faster.", "default": 2 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }