{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen.de Scraper with Contacts & Descriptions", "description": "Scrape Kleinanzeigen.de at scale with clean, structured listings. Capture titles, prices, descriptions, photos, locations and seller details for local offers and services. Ideal for price tracking, lead gen, resale sourcing and market research.", "version": "0.0", "x-build-id": "OCBpfvMgkfWSXwga8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~ebay-kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-ebay-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/fatihtahta~ebay-kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-ebay-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/fatihtahta~ebay-kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-ebay-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", "properties": { "startUrls": { "title": "Add Source URLs", "type": "array", "description": "Provide one Kleinanzeigen URL per line. Supported inputs include search pages, category pages, filtered result pages, /pro/ merchant profiles, and direct /s-anzeige/ listing URLs.", "items": { "type": "string" } }, "queries": { "title": "Add Search Terms", "type": "array", "description": "Enter one search term per line, such as a product name, brand, model, category, or market phrase. Each term is collected as its own source.", "items": { "type": "string" } }, "location": { "title": "Set Query Location", "type": "string", "description": "Limit search-query discovery to a city, district, or place name, such as Frankfurt am Main or Berlin. Leave empty for Germany-wide query discovery.", "default": "" }, "category": { "title": "Set Query Category", "enum": [ "", "210", "216", "223", "211", "217", "305", "306", "276", "280", "220", "241", "297", "288", "289", "290", "293", "291", "292", "294", "295", "296", "298", "231", "286", "254", "287", "252", "255", "257", "251", "256", "161", "172", "226", "245", "173", "176", "279", "278", "228", "225", "285", "175", "227", "405", "406", "168", "17", "236", "22", "19", "258", "21", "237", "25", "20", "23", "18", "185", "232", "248", "187", "282", "240", "191", "249", "233", "234", "230", "250", "189", "242", "80", "91", "93", "246", "239", "89", "90", "84", "86", "82", "81", "88", "87", "130", "138", "134", "136", "132", "135", "139", "133", "283", "243", "313", "195", "199", "402", "196", "275", "197", "277", "207", "208", "205", "203", "403", "238", "198", "102", "118", "111", "114", "110", "105", "107", "125", "123", "247", "117", "109", "153", "224", "154", "159", "160", "158", "156", "157", "155", "73", "76", "281", "284", "77", "79", "78", "74", "75", "400", "401", "235", "269", "260", "265", "263", "264", "262", "268", "261", "271", "267", "266", "270", "272", "273", "274", "192" ], "type": "string", "description": "Choose the Kleinanzeigen category used for search-query discovery. Leave as All categories when broad discovery is more important than category precision.", "default": "" }, "offer_type": { "title": "Filter by Offer Type", "enum": [ "", "for_sale", "requested" ], "type": "string", "description": "Choose whether search-query discovery should include sale listings, wanted ads, or both.", "default": "" }, "seller_type": { "title": "Filter by Seller Type", "enum": [ "", "private", "business" ], "type": "string", "description": "Choose whether search-query discovery should target private sellers, business sellers, or both.", "default": "" }, "buy_now": { "title": "Require Buy Now", "type": "boolean", "description": "Enable this to collect only query results where Kleinanzeigen marks direct purchase as available. Leave off for broader discovery.", "default": false }, "shipping": { "title": "Filter by Shipping Availability", "enum": [ "", "shipping_available", "pickup_only" ], "type": "string", "description": "Choose whether search-query discovery should target shippable listings, pickup-only listings, or both.", "default": "" }, "shipping_carrier": { "title": "Filter by Shipping Carrier", "enum": [ "", "dhl", "hermes" ], "type": "string", "description": "Choose a carrier when the workflow depends on DHL or Hermes delivery options. Leave empty when carrier does not matter.", "default": "" }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum listing price for search-query discovery. Use with Maximum Price to create a bounded market or budget band." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum listing price for search-query discovery. Use with Minimum Price to exclude listings outside the target price band." }, "condition": { "title": "Filter by Listing Condition", "uniqueItems": true, "type": "array", "description": "Choose one or more conditions for categories where Kleinanzeigen exposes this goods-style filter. Leave empty to include all available conditions.", "items": { "type": "string", "enum": [ "new", "very_good", "good", "okay", "defect" ], "enumTitles": [ "New", "Very good", "Good", "Acceptable", "Defect" ] }, "default": [] }, "car_make": { "title": "Filter by Car Make", "enum": [ "", "audi", "bmw", "mercedes_benz", "volkswagen", "opel", "ford", "skoda", "renault", "seat", "peugeot", "fiat", "hyundai", "toyota", "nissan", "mazda", "tesla", "sonstige_autos" ], "type": "string", "description": "Choose a vehicle make for Autos searches. Leave empty to include all makes within the selected Autos scope.", "default": "" }, "car_model": { "title": "Filter by Car Model", "type": "string", "description": "Optional vehicle model to apply with Car Make, such as A6, Golf, or Model 3. Use this when the workflow tracks a specific model line.", "default": "" }, "min_mileage": { "title": "Set Minimum Mileage", "minimum": 0, "type": "integer", "description": "Minimum mileage in kilometers for Autos searches. Use with Maximum Mileage to focus on a target usage band." }, "max_mileage": { "title": "Set Maximum Mileage", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometers for Autos searches. Lower values usually produce newer or less-used vehicle inventory." }, "min_first_registration_year": { "title": "Set Earliest Registration Year", "minimum": 1900, "type": "integer", "description": "Earliest first registration year for Autos searches. Use with Latest Registration Year to define the target vehicle age range." }, "max_first_registration_year": { "title": "Set Latest Registration Year", "minimum": 1900, "type": "integer", "description": "Latest first registration year for Autos searches. Leave empty if newer listings should not be capped." }, "fuel_type": { "title": "Filter by Fuel Type", "enum": [ "", "benzin", "diesel", "cng", "lpg", "hybrid", "elektro", "andere" ], "type": "string", "description": "Choose a fuel type for Autos searches. Leave empty when fuel type should not restrict the vehicle set.", "default": "" }, "transmission": { "title": "Filter by Transmission", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Choose automatic or manual transmission for Autos searches. Leave empty to include both.", "default": "" }, "vehicle_type": { "title": "Filter by Vehicle Type", "enum": [ "", "small_car", "sedan", "wagon", "convertible", "suv", "van", "coupe", "other" ], "type": "string", "description": "Choose a body type for Autos searches, such as sedan, SUV, wagon, or van.", "default": "" }, "damaged": { "title": "Filter by Damage Status", "enum": [ "", "damaged", "undamaged" ], "type": "string", "description": "Choose whether Autos searches should target damaged vehicles, undamaged vehicles, or both.", "default": "" }, "exterior_color": { "title": "Filter by Exterior Color", "enum": [ "", "black", "white", "gray", "silver", "blue", "red", "green", "brown", "beige", "yellow", "orange", "gold", "violet", "other" ], "type": "string", "description": "Choose an exterior color for Autos searches. Leave empty when color is not part of the target vehicle profile.", "default": "" }, "car_features": { "title": "Filter by Vehicle Features", "uniqueItems": true, "type": "array", "description": "Choose optional equipment filters for Autos searches, such as navigation, seat heating, Bluetooth, or full service history.", "items": { "type": "string", "enum": [ "trailer_coupling", "park_assistant", "alloy_wheels", "xenon_led_light", "air_conditioning", "navigation", "radio_tuner", "bluetooth", "handsfree", "sunroof", "seat_heating", "cruise_control", "non_smoking", "abs", "full_service_history" ], "enumTitles": [ "Trailer coupling", "Parking assistant", "Alloy wheels", "Xenon/LED headlights", "Air conditioning", "Navigation system", "Radio/Tuner", "Bluetooth", "Hands-free system", "Sunroof/Panoramic roof", "Seat heating", "Cruise control", "Non-smoking vehicle", "ABS", "Full service history" ] }, "default": [] }, "min_living_area": { "title": "Set Minimum Living Area", "minimum": 0, "type": "number", "description": "Minimum living area in square meters for Mietwohnungen searches. Use with Maximum Living Area to define a target size band." }, "max_living_area": { "title": "Set Maximum Living Area", "minimum": 0, "type": "number", "description": "Maximum living area in square meters for Mietwohnungen searches. Leave empty if larger apartments should remain in scope." }, "min_rooms": { "title": "Set Minimum Rooms", "minimum": 0, "type": "number", "description": "Minimum room count for Mietwohnungen searches. Decimal values can represent half-room layouts when Kleinanzeigen supports them." }, "max_rooms": { "title": "Set Maximum Rooms", "minimum": 0, "type": "number", "description": "Maximum room count for Mietwohnungen searches. Use with Minimum Rooms to keep rental exports aligned with a target housing profile." }, "min_floor": { "title": "Set Minimum Floor", "minimum": 0, "type": "integer", "description": "Minimum floor for Mietwohnungen searches. Leave empty when floor level is not part of the selection criteria." }, "max_floor": { "title": "Set Maximum Floor", "minimum": 0, "type": "integer", "description": "Maximum floor for Mietwohnungen searches. Use with Minimum Floor to focus on a target building-level range." }, "apartment_type": { "title": "Filter by Apartment Type", "enum": [ "", "attic", "ground_floor", "apartment_floor", "raised_ground_floor", "loft", "maisonette", "penthouse", "basement", "terrace", "other" ], "type": "string", "description": "Choose an apartment type for Mietwohnungen searches. Leave empty to include all rental apartment types.", "default": "" }, "online_viewing": { "title": "Filter by Online Viewing", "enum": [ "", "yes", "no" ], "type": "string", "description": "Choose whether Mietwohnungen searches should target listings with online viewing availability, no online viewing, or both.", "default": "" }, "swap_offer": { "title": "Filter by Swap Offer", "enum": [ "", "yes", "no" ], "type": "string", "description": "Choose whether Mietwohnungen searches should target swap-only listings, non-swap listings, or both.", "default": "" }, "home_garden_color": { "title": "Filter by Color", "enum": [ "", "other", "beige", "blue", "brown", "multicolor", "burgundy", "yellow", "gold", "gray", "green", "wood", "khaki", "purple", "orange", "pink", "red", "black", "silver", "transparent", "white" ], "type": "string", "description": "Choose a color for Haus & Garten searches. Leave empty when color should not restrict the result set.", "default": "" }, "home_garden_material": { "title": "Filter by Material", "enum": [ "", "cotton", "organic_cotton", "bronze", "oak", "iron", "flannel", "glass", "wood", "ceramic", "pine", "rattan_wicker", "fake_fur", "plastic", "lacquered", "leather", "linen", "marble", "solid_wood", "metal", "mixed_fabric", "natural_fibres", "pvc_synthetic", "paper", "cotton_percale", "polyester", "velvet", "cotton_satin", "formica", "other", "steel", "stone", "fabric", "viscose", "oilcloth", "wool" ], "type": "string", "description": "Choose a material for Haus & Garten searches, such as solid wood, metal, glass, fabric, or leather.", "default": "" }, "enrich_data": { "title": "Collect Richer Listing Details", "type": "boolean", "description": "Enable this for more complete listings, including full descriptions, listing attributes, address details, image links, price context, seller context, and shipping details when available. Leave it off for faster runs when standard result fields are enough.", "default": false }, "maximize_coverage": { "title": "Maximize Search Coverage", "type": "boolean", "description": "Enable this for broad search or category runs where Kleinanzeigen reports more matching listings than a single result window can reliably return. The run expands only with strict coverage-safe filters and will not use price ranges as a fallback when that would drop negotiable or unpriced listings.", "default": false }, "limit": { "title": "Set Output Limit per Source", "minimum": 1, "type": "integer", "description": "Maximum records to save for each source URL or search term. Use a smaller value for validation and a larger value for scheduled exports or downstream ETL batches." } } }, "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 } } } } } } } } } }