{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper – Listings, Prices, Sellers & Alerts", "description": "Scrape Kleinanzeigen.de (ex eBay Kleinanzeigen) listings with every filter or any URL: prices, price drops, full details, photos, GPS, seller profiles and PRO shops, no 1,250-result limit, and monitoring of new, reduced and sold listings.", "version": "1.0", "x-build-id": "lXbRJNQz3biMgGmv3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/liveclaude~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-liveclaude-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/liveclaude~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-liveclaude-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/liveclaude~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-liveclaude-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": { "searchQueries": { "title": "🔎 Search terms", "type": "array", "description": "What to search for, e.g. iphone 15, sofa, golf 7. One search per line. Leave empty to scrape whole categories or locations.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Kleinanzeigen URLs", "type": "array", "description": "Paste any kleinanzeigen.de link: search or category pages with your filters (also category-specific ones like mileage, rooms or storage), single listings (/s-anzeige/...), seller pages (s-bestandsliste.html?userId=...) or PRO shops (/pro/...).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categories": { "title": "📂 Categories", "type": "array", "description": "Limit the search to categories. Combined with every search term. For deeper category filters (brand, mileage, rooms...) set them on kleinanzeigen.de and paste the URL above.", "items": { "type": "string", "enum": [ "195", "208", "203", "196", "277", "207", "197", "238", "275", "199", "402", "205", "403", "153", "224", "154", "159", "160", "158", "156", "157", "210", "216", "223", "211", "217", "306", "305", "276", "280", "220", "80", "86", "246", "84", "88", "89", "82", "90", "81", "93", "91", "239", "102", "109", "111", "107", "123", "247", "117", "110", "114", "118", "105", "125", "161", "176", "225", "172", "227", "245", "175", "173", "279", "409", "278", "285", "405", "228", "406", "407", "226", "408", "17", "236", "22", "19", "258", "21", "237", "25", "20", "23", "130", "138", "134", "136", "132", "135", "139", "133", "283", "243", "313", "185", "234", "230", "240", "282", "249", "187", "248", "233", "250", "232", "191", "189", "73", "76", "281", "284", "77", "79", "78", "74", "231", "286", "254", "287", "252", "255", "257", "251", "256", "297", "288", "289", "290", "293", "291", "292", "294", "295", "296", "298", "272", "273", "274", "192", "235", "268", "263", "266", "270", "271", "262", "269", "261", "264", "267", "265", "260", "400" ], "enumTitles": [ "Immobilien (all)", "Immobilien > Häuser zum Kauf", "Immobilien > Mietwohnungen", "Immobilien > Eigentumswohnungen", "Immobilien > Gewerbeimmobilien", "Immobilien > Grundstücke & Gärten", "Immobilien > Garagen & Stellplätze", "Immobilien > Umzug & Transport", "Immobilien > Ferien- & Auslandsimmobilien", "Immobilien > Auf Zeit & WG", "Immobilien > Container", "Immobilien > Häuser zur Miete", "Immobilien > Neubauprojekte", "Mode & Beauty (all)", "Mode & Beauty > Beauty & Gesundheit", "Mode & Beauty > Damenbekleidung", "Mode & Beauty > Damenschuhe", "Mode & Beauty > Herrenbekleidung", "Mode & Beauty > Herrenschuhe", "Mode & Beauty > Taschen & Accessoires", "Mode & Beauty > Uhren & Schmuck", "Auto, Rad & Boot (all)", "Auto, Rad & Boot > Autos", "Auto, Rad & Boot > Autoteile & Reifen", "Auto, Rad & Boot > Boote & Bootszubehör", "Auto, Rad & Boot > Fahrräder & Zubehör", "Auto, Rad & Boot > Motorradteile & Zubehör", "Auto, Rad & Boot > Motorräder & Motorroller", "Auto, Rad & Boot > Nutzfahrzeuge & Anhänger", "Auto, Rad & Boot > Reparaturen & Dienstleistungen", "Auto, Rad & Boot > Wohnwagen & -mobile", "Haus & Garten (all)", "Haus & Garten > Küche & Esszimmer", "Haus & Garten > Dekoration", "Haus & Garten > Heimwerken", "Haus & Garten > Wohnzimmer", "Haus & Garten > Gartenzubehör & Pflanzen", "Haus & Garten > Lampen & Licht", "Haus & Garten > Heimtextilien", "Haus & Garten > Schlafzimmer", "Haus & Garten > Büro", "Haus & Garten > Badezimmer", "Haus & Garten > Dienstleistungen Haus & Garten", "Jobs (all)", "Jobs > Weitere Jobs", "Jobs > Bau, Handwerk & Produktion", "Jobs > Mini- & Nebenjobs", "Jobs > Sozialer Sektor & Pflege", "Jobs > Transport, Logistik & Verkehr", "Jobs > Vertrieb, Einkauf & Verkauf", "Jobs > Gastronomie & Tourismus", "Jobs > Büroarbeit & Verwaltung", "Jobs > Ausbildung", "Jobs > Kundenservice & Call Center", "Jobs > Praktika", "Elektronik (all)", "Elektronik > Haushaltsgeräte", "Elektronik > PC-Zubehör & Software", "Elektronik > Audio & Hifi", "Elektronik > Videospiele", "Elektronik > Foto", "Elektronik > TV & Video", "Elektronik > Smartphones", "Elektronik > Konsolen", "Elektronik > Smartphone Zubehör", "Elektronik > Laptops & Notebooks", "Elektronik > Tablets & Reader", "Elektronik > Wearables", "Elektronik > PCs", "Elektronik > Wearables Zubehör", "Elektronik > Telefone & Fax", "Elektronik > Dienstleistungen Elektronik", "Elektronik > Kommunikation & Funk", "Familie, Kind & Baby (all)", "Familie, Kind & Baby > Altenpflege", "Familie, Kind & Baby > Baby- & Kinderkleidung", "Familie, Kind & Baby > Baby- & Kinderschuhe", "Familie, Kind & Baby > Baby-Ausstattung", "Familie, Kind & Baby > Babyschalen & Kindersitze", "Familie, Kind & Baby > Babysitter/-in & Kinderbetreuung", "Familie, Kind & Baby > Kinderwagen & Buggys", "Familie, Kind & Baby > Kinderzimmermöbel", "Familie, Kind & Baby > Spielzeug", "Haustiere (all)", "Haustiere > Fische", "Haustiere > Hunde", "Haustiere > Katzen", "Haustiere > Kleintiere", "Haustiere > Nutztiere", "Haustiere > Pferde", "Haustiere > Tierbetreuung & Training", "Haustiere > Vermisste Tiere", "Haustiere > Vögel", "Haustiere > Zubehör", "Freizeit, Hobby & Nachbarschaft (all)", "Freizeit, Hobby & Nachbarschaft > Sammeln", "Freizeit, Hobby & Nachbarschaft > Sport & Camping", "Freizeit, Hobby & Nachbarschaft > Kunst & Antiquitäten", "Freizeit, Hobby & Nachbarschaft > Handarbeit, Basteln & Kunsthandwerk", "Freizeit, Hobby & Nachbarschaft > Modellbau", "Freizeit, Hobby & Nachbarschaft > Freizeitaktivitäten", "Freizeit, Hobby & Nachbarschaft > Essen & Trinken", "Freizeit, Hobby & Nachbarschaft > Reise & Eventservices", "Freizeit, Hobby & Nachbarschaft > Trödel", "Freizeit, Hobby & Nachbarschaft > Esoterik & Spirituelles", "Freizeit, Hobby & Nachbarschaft > Künstler/-in & Musiker/-in", "Freizeit, Hobby & Nachbarschaft > Verloren & Gefunden", "Musik, Filme & Bücher (all)", "Musik, Filme & Bücher > Bücher & Zeitschriften", "Musik, Filme & Bücher > Büro & Schreibwaren", "Musik, Filme & Bücher > Comics", "Musik, Filme & Bücher > Fachbücher, Schule & Studium", "Musik, Filme & Bücher > Film & DVD", "Musik, Filme & Bücher > Musik & CDs", "Musik, Filme & Bücher > Musikinstrumente", "Eintrittskarten & Tickets (all)", "Eintrittskarten & Tickets > Bahn & ÖPNV", "Eintrittskarten & Tickets > Comedy & Kabarett", "Eintrittskarten & Tickets > Gutscheine", "Eintrittskarten & Tickets > Kinder", "Eintrittskarten & Tickets > Konzerte", "Eintrittskarten & Tickets > Sport", "Eintrittskarten & Tickets > Theater & Musical", "Eintrittskarten & Tickets > Weitere Eintrittskarten & Tickets", "Dienstleistungen (all)", "Dienstleistungen > Altenpflege", "Dienstleistungen > Auto, Rad & Boot", "Dienstleistungen > Babysitter/-in & Kinderbetreuung", "Dienstleistungen > Elektronik", "Dienstleistungen > Haus & Garten", "Dienstleistungen > Künstler/-in & Musiker/-in", "Dienstleistungen > Reise & Event", "Dienstleistungen > Tierbetreuung & Training", "Dienstleistungen > Umzug & Transport", "Dienstleistungen > Weitere Dienstleistungen", "Verschenken & Tauschen (all)", "Verschenken & Tauschen > Tauschen", "Verschenken & Tauschen > Verleihen", "Verschenken & Tauschen > Verschenken", "Unterricht & Kurse (all)", "Unterricht & Kurse > Nachhilfe", "Unterricht & Kurse > Kochen & Backen", "Unterricht & Kurse > Weiterbildung", "Unterricht & Kurse > Weitere Unterricht & Kurse", "Unterricht & Kurse > Sprachkurse", "Unterricht & Kurse > Musik & Gesang", "Unterricht & Kurse > Beauty & Gesundheit", "Unterricht & Kurse > Sportkurse", "Unterricht & Kurse > Kunst & Gestaltung", "Unterricht & Kurse > Tanzkurse", "Unterricht & Kurse > Esoterik & Spirituelles", "Unterricht & Kurse > Computerkurse", "Nachbarschaftshilfe (all)" ] } }, "location": { "title": "📍 Location (city or postcode)", "type": "string", "description": "City, district or postcode, e.g. Berlin, München, 50667. Empty = all of Germany." }, "radiusKm": { "title": "Radius around the location", "enum": [ "0", "1", "2", "3", "5", "10", "15", "20", "30", "50", "100", "150", "200" ], "type": "string", "description": "Search radius around the location.", "default": "0" }, "priceMin": { "title": "Min. price (€)", "minimum": 0, "type": "integer", "description": "Minimum price in EUR." }, "priceMax": { "title": "Max. price (€)", "minimum": 0, "type": "integer", "description": "Maximum price in EUR." }, "offerType": { "title": "Listing type", "enum": [ "all", "offers", "wanted" ], "type": "string", "description": "Offers or wanted ads.", "default": "all" }, "sellerType": { "title": "Seller type", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Private or commercial sellers.", "default": "all" }, "shipping": { "title": "Shipping", "enum": [ "all", "shipping", "pickup" ], "type": "string", "description": "Only listings with shipping, or pickup only.", "default": "all" }, "buyNowOnly": { "title": "Only \"Direkt kaufen\" (buy now)", "type": "boolean", "description": "Only listings that can be bought directly with Kleinanzeigen payment.", "default": false }, "postedWithinHours": { "title": "Posted within (hours)", "minimum": 1, "type": "integer", "description": "Only listings posted in the last X hours, e.g. 24. Search stops as soon as older listings appear (fast and cheap for daily runs)." }, "excludeKeywords": { "title": "Exclude words", "type": "array", "description": "Skip listings whose title or snippet contains any of these words, e.g. defekt, suche, tausch.", "items": { "type": "string" } }, "titleMustInclude": { "title": "Title must include (any)", "type": "array", "description": "Keep only listings whose title contains at least one of these words.", "items": { "type": "string" } }, "onlyPriceReduced": { "title": "Only price-reduced listings", "type": "boolean", "description": "Only listings where the seller lowered the price (crossed-out old price shown).", "default": false }, "includeTopAds": { "title": "Include TOP (promoted) ads", "type": "boolean", "description": "Promoted listings appear on top of results. Turn off to keep only organic results.", "default": true }, "sortBy": { "title": "Sort by", "enum": [ "newest", "price_asc", "price_desc", "distance" ], "type": "string", "description": "Order of results.", "default": "newest" }, "maxItemsPerSearch": { "title": "Max. listings per search", "minimum": 0, "type": "integer", "description": "Maximum listings per search term / URL / seller. 0 = all.", "default": 100 }, "bypassResultLimit": { "title": "Get more than 1,250 results", "type": "boolean", "description": "Kleinanzeigen shows max. 50 pages (1,250 listings) per search. When on, big searches are split into price ranges automatically to collect more.", "default": true }, "includeDetails": { "title": "➕ Listing details", "type": "boolean", "description": "Open every listing: full description, all attributes (brand, model, mileage, rooms...), all photos, GPS coordinates, shipping cost, seller name, type, rating badges and member since. Charged as an extra event.", "default": false }, "sellers": { "title": "👤 Sellers to track", "type": "array", "description": "Seller user IDs (e.g. 73444737), seller page links or PRO shop links/names (e.g. cartech). Returns the seller profile (and for PRO shops: company contact, address, website, opening hours) plus all their listings.", "items": { "type": "string" } }, "includeSellerListings": { "title": "Include seller's listings", "type": "boolean", "description": "Also return all active listings of each tracked seller.", "default": true }, "includeSellerProfile": { "title": "Add seller profile to every listing", "type": "boolean", "description": "Adds seller name, type, followers, reply time and badges to every listing (opens the listing to find the seller). Charged per unique seller.", "default": false }, "onlyNewItems": { "title": "🔔 Only new listings (monitoring)", "type": "boolean", "description": "Remember listings between runs and return only new ones, price drops and (optionally) sold or deleted listings. Schedule the Actor to get alerts.", "default": false }, "monitorId": { "title": "Monitor name", "type": "string", "description": "Optional name to keep separate memories for different monitors (e.g. bikes-berlin). Default: derived from your searches." }, "emitOnFirstRun": { "title": "Return all listings on the first run", "type": "boolean", "description": "First monitoring run returns everything found. Turn off to only save a baseline.", "default": true }, "trackPriceDrops": { "title": "Report price drops", "type": "boolean", "description": "Return already seen listings again when their price went down.", "default": true }, "detectSoldItems": { "title": "Detect sold / reserved / deleted listings", "type": "boolean", "description": "Checks listings that disappeared from your searches and reports them as sold, reserved or removed, with days on market.", "default": true }, "priceSummary": { "title": "📊 Price summary per search", "type": "boolean", "description": "Adds one record per search with min / median / average / max price, quartiles, share of negotiable, reduced and shippable listings and top locations.", "default": false }, "maxConcurrency": { "title": "Max. concurrency", "minimum": 1, "maximum": 40, "type": "integer", "description": "Parallel requests.", "default": 20 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used automatically. You can bring your own proxy URLs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }