{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper", "description": "Scrape Kleinanzeigen.de (ex eBay Kleinanzeigen): any search or category, price, location, photos, seller. Every filter: cars, motorbikes, flats, houses. No 1,250 cap. Optional details: description, attributes, GPS, views, and dealer phone, email, VAT and imprint for lead lists.", "version": "1.0", "x-build-id": "1dKcR0QpgadQxitJf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-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/normdata~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-normdata-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/normdata~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-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": { "maxItems": { "title": "Maximum ads", "minimum": 1, "type": "integer", "description": "Stop after this many ads. Leave empty for no limit (every ad that matches, even past Kleinanzeigen's 1,250-results-per-search cap). The Apify Free plan is always capped at 10." }, "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type in the Kleinanzeigen search box, e.g. \"iphone 15\", \"sofa\", \"golf 7\", \"ps5\". Each line is its own search. Leave empty to list every ad in the category below.", "items": { "type": "string" } }, "urls": { "title": "...or paste links", "type": "array", "description": "Kleinanzeigen search pages with all their filters (e.g. kleinanzeigen.de/s-autos/berlin/c216l3331) or single ads (kleinanzeigen.de/s-anzeige/...). Search links keep their own filters; the filters below apply to Search terms.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "Category", "enum": [ "210", "216", "223", "211", "217", "305", "306", "276", "280", "220", "241", "161", "172", "226", "245", "176", "408", "279", "278", "228", "225", "173", "285", "407", "175", "227", "405", "406", "168", "80", "91", "93", "246", "239", "89", "90", "84", "86", "82", "81", "88", "87", "102", "118", "111", "114", "110", "105", "107", "125", "123", "247", "117", "109", "400", "401", "297", "288", "289", "290", "293", "291", "292", "294", "295", "296", "298", "17", "236", "22", "19", "258", "21", "237", "25", "20", "23", "18", "130", "138", "134", "136", "132", "135", "139", "133", "283", "243", "313", "153", "224", "154", "159", "160", "158", "156", "157", "155", "235", "269", "260", "265", "263", "264", "262", "268", "261", "271", "267", "266", "270", "231", "286", "254", "287", "252", "255", "257", "251", "256", "185", "232", "248", "187", "282", "240", "191", "249", "233", "234", "230", "250", "189", "242", "195", "199", "402", "196", "275", "197", "277", "207", "208", "205", "203", "403", "238", "198", "73", "76", "281", "284", "77", "79", "78", "74", "75", "272", "273", "274", "192" ], "type": "string", "description": "Only ads in this category or subcategory. Leave empty for all categories. Car, motorbike and real estate filters below need their category (they pick it for you when left empty)." }, "location": { "title": "Near (city, district or postcode)", "type": "string", "description": "A German city, district or postcode, e.g. \"Berlin\", \"Hamburg Altona\", \"80331\". Leave empty for all of Germany." }, "radiusKm": { "title": "Radius", "enum": [ "5", "10", "20", "30", "50", "100", "150", "200" ], "type": "string", "description": "Distance around the place above. Leave empty for the place itself." }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Leave empty for no limit. Set 0 for free items (Zu verschenken)." }, "sellerType": { "title": "Seller", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Private sellers, commercial sellers (shops and dealers) or both.", "default": "all" }, "adType": { "title": "Ad type", "enum": [ "all", "offer", "wanted" ], "type": "string", "description": "Offers (Angebote), wanted ads (Gesuche) or both.", "default": "all" }, "condition": { "title": "Condition", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "new", "like_new", "good", "acceptable", "defective" ], "enumTitles": [ "New", "Like new", "Good", "Acceptable", "Defective" ] } }, "colors": { "title": "Colour", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "black", "white", "grey", "silver", "blue", "red", "green", "yellow", "orange", "brown", "beige", "gold", "purple", "violet", "pink", "rose", "turquoise", "cream", "burgundy", "khaki", "wood", "multicolor", "transparent", "other" ], "enumTitles": [ "Black", "White", "Grey", "Silver", "Blue", "Red", "Green", "Yellow", "Orange", "Brown", "Beige", "Gold", "Purple", "Violet (cars)", "Pink", "Rose", "Turquoise", "Cream", "Burgundy", "Khaki", "Wood", "Multicoloured", "Transparent", "Other" ] } }, "shipping": { "title": "Shipping", "enum": [ "all", "shipping", "pickup" ], "type": "string", "description": "Ads that ship, pickup only, or both.", "default": "all" }, "parcelService": { "title": "Parcel service", "enum": [ "all", "dhl", "hermes" ], "type": "string", "description": "Only ads that ship with this carrier.", "default": "all" }, "directBuyOnly": { "title": "Direct buy only", "type": "boolean", "description": "Keep only ads with \"Direkt kaufen\" (buy now with Kleinanzeigen payment protection).", "default": false }, "withPhotosOnly": { "title": "With photos only", "type": "boolean", "description": "Keep only ads that have at least one photo.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "default", "newest", "price_low", "price_high", "distance", "recommended" ], "type": "string", "description": "Order of the results. Matters most when you set a Maximum.", "default": "default" }, "makes": { "title": "Makes", "type": "array", "description": "Car or motorbike makes, e.g. \"BMW\", \"Volkswagen\", \"Mercedes-Benz\", \"Harley\". Keeps ANY of them. Add a model with Extra filters, e.g. \"autos.model_s:golf\".", "items": { "type": "string" } }, "minYear": { "title": "First registration from (year)", "minimum": 0, "type": "integer", "description": "e.g. 2015." }, "maxYear": { "title": "First registration until (year)", "minimum": 0, "type": "integer", "description": "e.g. 2022." }, "minMileage": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Leave empty for no limit." }, "minPowerPs": { "title": "Min power (PS)", "minimum": 0, "type": "integer", "description": "Horsepower (PS)." }, "maxPowerPs": { "title": "Max power (PS)", "minimum": 0, "type": "integer", "description": "Horsepower (PS)." }, "gearbox": { "title": "Gearbox", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "automatic", "manual" ], "enumTitles": [ "Automatic", "Manual" ] } }, "fuel": { "title": "Fuel (cars)", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid", "lpg", "cng", "other" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid", "LPG", "CNG", "Other" ] } }, "carBodyTypes": { "title": "Body type (cars)", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "small_car", "sedan", "estate", "convertible", "suv", "van", "coupe", "other" ], "enumTitles": [ "Small car", "Sedan", "Estate", "Convertible", "SUV / off-road", "Van / minibus", "Coupe", "Other" ] } }, "doors": { "title": "Doors (cars)", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "2_3", "4_5", "6_7", "other" ], "enumTitles": [ "2/3", "4/5", "6/7", "Other" ] } }, "damagedVehicles": { "title": "Damaged vehicles (cars)", "enum": [ "include", "exclude", "only" ], "type": "string", "description": "Include, hide or keep only damaged cars.", "default": "include" }, "emissionClass": { "title": "Emission class (cars)", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "euro1", "euro2", "euro3", "euro4", "euro5", "euro6" ], "enumTitles": [ "Euro 1", "Euro 2", "Euro 3", "Euro 4", "Euro 5", "Euro 6" ] } }, "emissionSticker": { "title": "Emission sticker (cars)", "type": "array", "description": "German Umweltplakette. Keep only ANY of these.", "items": { "type": "string", "enum": [ "green", "yellow", "red", "none" ], "enumTitles": [ "Green (4)", "Yellow (3)", "Red (2)", "None (1)" ] } }, "upholstery": { "title": "Upholstery (cars)", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "full_leather", "part_leather", "cloth", "velour", "alcantara", "other" ], "enumTitles": [ "Full leather", "Part leather", "Cloth", "Velour", "Alcantara", "Other" ] } }, "minInspectionYear": { "title": "Inspection (TÜV) valid until at least (year)", "minimum": 0, "type": "integer", "description": "Cars only, e.g. 2027." }, "motorbikeTypes": { "title": "Motorbike type", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "motorbike", "scooter", "moped", "quad" ], "enumTitles": [ "Motorbike", "Scooter", "Moped", "Quad" ] } }, "minEngineCc": { "title": "Min engine size (cc)", "minimum": 0, "type": "integer", "description": "Motorbikes only." }, "maxEngineCc": { "title": "Max engine size (cc)", "minimum": 0, "type": "integer", "description": "Motorbikes only." }, "minRooms": { "title": "Min rooms", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxRooms": { "title": "Max rooms", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "minSizeSqm": { "title": "Min living space (m²)", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxSizeSqm": { "title": "Max living space (m²)", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "apartmentTypes": { "title": "Apartment type", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "upper_floor", "ground_floor", "attic", "raised_ground_floor", "basement", "loft", "maisonette", "penthouse", "terrace", "other" ], "enumTitles": [ "Upper floor", "Ground floor", "Attic / top floor", "Raised ground floor", "Basement", "Loft", "Maisonette", "Penthouse", "Terrace apartment", "Other" ] } }, "houseTypes": { "title": "House type", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "detached", "semi_detached", "terraced", "multi_family", "bungalow", "farmhouse", "villa", "other" ], "enumTitles": [ "Detached house", "Semi-detached", "Terraced house", "Multi-family house", "Bungalow", "Farmhouse", "Villa", "Other" ] } }, "minPlotSqm": { "title": "Min plot size (m²)", "minimum": 0, "type": "integer", "description": "Houses for sale." }, "maxPlotSqm": { "title": "Max plot size (m²)", "minimum": 0, "type": "integer", "description": "Houses for sale." }, "minBuildYear": { "title": "Built from (year)", "minimum": 0, "type": "integer", "description": "Houses for sale." }, "maxBuildYear": { "title": "Built until (year)", "minimum": 0, "type": "integer", "description": "Houses for sale." }, "noCommissionOnly": { "title": "No buyer commission only", "type": "boolean", "description": "Apartments and houses for sale without a broker commission for the buyer (provisionsfrei).", "default": false }, "onlineTourOnly": { "title": "Online tour only", "type": "boolean", "description": "Keep only listings with an online viewing tour.", "default": false }, "extraFilters": { "title": "Extra filters", "type": "array", "description": "Any other Kleinanzeigen filter as \"key:value\", e.g. \"autos.model_s:golf\", \"wohnung_mieten.etage_i:2,5\" (a range), \"handy_telekom.art_s:apple\", \"wohnzimmer.art_s:sofas_sitzgarnituren\". Copy them from a Kleinanzeigen search link (the parts after \"+\").", "items": { "type": "string" } }, "onlyNew": { "title": "New ads only", "type": "boolean", "description": "For scheduled runs: save only ads this same search has not saved before. The first run saves everything; later runs save just what was posted since. Kept per search (terms, links and filters).", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Give \"New ads only\" a fixed name to keep its memory even after you change the filters." }, "includeDetails": { "title": "Full details", "type": "boolean", "description": "Reads each full ad and adds: full description, all photos, every attribute (make, model, mileage, rooms, size, type...), features, GPS, state and district, street, views, seller name, ID, profile, member since, rating and badges, active ads, and for commercial sellers their phone, email, company, address imprint, VAT ID and register number. Paid add-on: one extra charge per ad saved with details (see Pricing).", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional, off by default. Kleinanzeigen normally works fine without one. Turn it on only if your runs get blocked (\"temporarily blocked this IP range\"). Pick the Residential group with country Germany; datacenter proxies are mostly blocked by Kleinanzeigen. Proxy traffic is billed to your Apify account." } } }, "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 } } } } } } } } } }