{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper - Listings, Real Estate, Cars & Sellers", "description": "Scrape kleinanzeigen.de listings by keyword, category, location, price and filters, or from search, listing and seller URLs: price, location, date, seller, photos. Add-ons: listing details with real-estate and car fields, seller profiles, price stats. Monitor new listings. $0.33 per 1,000 listings.", "version": "0.1", "x-build-id": "OeOhRX3sOBBCeGS32" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/topapi~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-topapi-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/topapi~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-topapi-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/topapi~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-topapi-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 keywords", "type": "array", "description": "What you would type in the kleinanzeigen.de search box, one per line, e.g. \"iphone 15\", \"e-bike\", \"3 zimmer wohnung\". Leave empty to browse a category or location.", "items": { "type": "string" } }, "startUrls": { "title": "πŸ”— kleinanzeigen.de URLs", "type": "array", "description": "Search or category pages copied from your browser with every filter set (kleinanzeigen.de/s-wohnung-mieten/berlin/c203l3331), listing pages (/s-anzeige/...), seller pages (/s-bestandsliste.html?userId=...) and PRO shops (/pro/...).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Listing ids", "type": "array", "description": "Anzeigen-IDs or listing URLs, one per line, e.g. 3549201628. Each returns the full listing page (details included, one listing charge).", "items": { "type": "string" } }, "sellerIds": { "title": "Sellers", "type": "array", "description": "Seller user ids (e.g. 81106945), seller page URLs or PRO shop names / URLs (e.g. Verbeek-Immobilien): every listing the seller has online.", "items": { "type": "string" } }, "urlsFromFile": { "title": "URLs from a file", "type": "string", "description": "Many URLs at once: paste them one per line, or one link to a .txt / .csv file that lists them." }, "category": { "title": "πŸ“‚ 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", "176", "408", "279", "278", "228", "225", "173", "409", "285", "407", "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": "Search inside one category (all 160 of the site's own). Empty = all categories.", "default": "" }, "location": { "title": "πŸ“ Location", "type": "string", "description": "City, district, zip code or state, e.g. \"Berlin\", \"80331\", \"Bayern\" (matched with the site's own location list). Empty = all of Germany." }, "zipCodes": { "title": "Zip codes", "type": "array", "description": "Search each zip code separately (with the radius below), e.g. 10115, 20095. Used together with Location when both are set.", "items": { "type": "string" } }, "radius": { "title": "Radius (km)", "enum": [ "", "1", "2", "3", "5", "10", "15", "20", "30", "50", "100", "150", "200" ], "type": "string", "description": "Distance around the location or zip code. Needs a location.", "default": "" }, "minPrice": { "title": "Min price (€)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Lowest price in euros. As on the website, listings without a price drop out once a price limit is set." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Highest price in euros." }, "sellerType": { "title": "Seller", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Private sellers (privat) or commercial sellers (gewerblich).", "default": "all" }, "adType": { "title": "Offer or wanted", "enum": [ "all", "offered", "wanted" ], "type": "string", "description": "kleinanzeigen.de shows offers and wanted ads together; pick one to narrow it.", "default": "all" }, "buyNowOnly": { "title": "Buy now only", "type": "boolean", "description": "Only listings with \"Direkt kaufen\" (buy now with buyer protection).", "default": false }, "shipping": { "title": "Shipping", "enum": [ "all", "shippable", "pickup" ], "type": "string", "description": "Whether the seller ships (Versand mΓΆglich) or only offers pickup.", "default": "all" }, "sorting": { "title": "Sort by", "enum": [ "newest", "price_asc", "price_desc", "distance", "relevance" ], "type": "string", "description": "Order the listings are collected in. Monitor mode and the posted-within filter always read newest first.", "default": "newest" }, "minRooms": { "title": "🏠 Min rooms", "minimum": 0, "maximum": 100, "type": "number", "description": "Real estate: fewest rooms (Zimmer), e.g. 2. Without a category, Mietwohnungen is searched." }, "maxRooms": { "title": "🏠 Max rooms", "minimum": 0, "maximum": 100, "type": "number", "description": "Real estate: most rooms." }, "minArea": { "title": "🏠 Min area (mΒ²)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Real estate: smallest living / plot area in mΒ², e.g. 50." }, "maxArea": { "title": "🏠 Max area (mΒ²)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Real estate: largest area in mΒ²." }, "carMake": { "title": "πŸš— Make", "type": "string", "description": "Cars / motorbikes: make as on the site, e.g. \"BMW\", \"Mercedes Benz\", \"Volkswagen\". Without a category, Autos is searched." }, "carModel": { "title": "πŸš— Model", "type": "string", "description": "Cars: model, e.g. \"Golf\", \"A4\" (needs a make)." }, "minYear": { "title": "πŸš— First registration from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Cars / motorbikes: earliest first-registration year (Erstzulassung), e.g. 2015." }, "maxYear": { "title": "πŸš— First registration to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Cars / motorbikes: latest first-registration year." }, "minMileage": { "title": "πŸš— Min mileage (km)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Cars / motorbikes: lowest mileage." }, "maxMileage": { "title": "πŸš— Max mileage (km)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Cars / motorbikes: highest mileage, e.g. 100000." }, "minPowerPs": { "title": "πŸš— Min power (PS)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Cars / motorbikes: lowest power in PS." }, "maxPowerPs": { "title": "πŸš— Max power (PS)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Cars / motorbikes: highest power in PS." }, "fuel": { "title": "πŸš— Fuel", "enum": [ "", "benzin", "diesel", "elektro", "hybrid", "lpg", "cng", "andere" ], "type": "string", "description": "Cars: fuel type.", "default": "" }, "transmission": { "title": "πŸš— Gearbox", "enum": [ "", "automatik", "manuell" ], "type": "string", "description": "Cars / motorbikes: transmission.", "default": "" }, "filters": { "title": "Other category filters", "type": "object", "description": "Any other filter of the chosen category, as the site names it in its URLs, e.g. {\"zimmer_d\": \"2,3\", \"versand_s\": \"ja\", \"autos.schaden_s\": \"f\"}. Names without a prefix get the category's own." }, "includeKeywords": { "title": "Must contain", "type": "array", "description": "Keep only listings whose title or description contains at least one of these words, e.g. \"ovp\", \"garantie\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not contain", "type": "array", "description": "Drop listings whose title or description contains any of these words, e.g. \"defekt\", \"tausch\".", "items": { "type": "string" } }, "postedWithinHours": { "title": "Posted within (hours)", "minimum": 1, "maximum": 8760, "type": "integer", "description": "Only listings posted in the last N hours, e.g. 24. The search stops at the first older page, so daily runs stay small and cheap." }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only listings posted on or after this date (YYYY-MM-DD)." }, "includeTopAds": { "title": "Include top ads", "type": "boolean", "description": "Paid top ads appear above the results on every page. Off = organic listings only.", "default": true }, "onlyPriceReduced": { "title": "Only price-reduced", "type": "boolean", "description": "Only listings whose seller lowered the price (a crossed-out old price is shown).", "default": false }, "photosOnly": { "title": "Only with photos", "type": "boolean", "description": "Drop listings without a photo.", "default": false }, "includeDetails": { "title": "βž• Listing details", "type": "boolean", "description": "Opens each listing page: full description, all attributes, GPS + street, views, status, seller name / since / rating, imprint, plus typed real-estate, vehicle and job columns. $0.00033 per listing extra.", "default": false }, "includeSellerDetails": { "title": "βž• Seller profiles", "type": "boolean", "description": "One extra row per unique seller: rating, badges, reply time, followers, listings online / total and, for PRO shops, phone, address, opening hours, website. $0.0018 per seller.", "default": false }, "priceSummary": { "title": "βž• Price summary", "type": "boolean", "description": "One statistics row per search: min / p25 / median / average / p75 / max price, negotiable, reduced, shipping and commercial shares, top locations. $0.009 per search.", "default": false }, "monitorMode": { "title": "πŸ” Only new listings (monitor)", "type": "boolean", "description": "Remembers delivered listings per search in a named key-value store and returns only new ones (newest first; a poll with nothing new reads one page and charges nothing). Pairs with a schedule.", "default": false }, "monitorStoreName": { "title": "Monitor memory name", "type": "string", "description": "Named key-value store that keeps what was delivered. Use one name per schedule.", "default": "kleinanzeigen-monitor" }, "alertOnPriceDrop": { "title": "Also price drops", "type": "boolean", "description": "Monitor mode: also return a listing seen before when its price went down (change_type = price_drop, previous_price).", "default": false }, "minPriceDropPct": { "title": "Min price drop (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Only report a price drop of at least this many percent.", "default": 0 }, "skipFirstRun": { "title": "Skip first run", "type": "boolean", "description": "The first monitor run only remembers the current listings (nothing delivered or charged); later runs return what is new.", "default": false }, "resetMonitor": { "title": "Reset memory", "type": "boolean", "description": "Forget what earlier runs delivered for these searches.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST the run's new listings (JSON) to this URL after the run." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Extra headers for the webhook, e.g. {\"Authorization\": \"Bearer ...\"}." }, "slackWebhookUrl": { "title": "Slack webhook", "type": "string", "description": "Slack incoming-webhook URL for a message with the new listings." }, "discordWebhookUrl": { "title": "Discord webhook", "type": "string", "description": "Discord webhook URL for a message with the new listings." }, "telegramToken": { "title": "Telegram bot token", "type": "string", "description": "Telegram bot token (with the chat id below)." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Chat or user id the bot writes to (send /start to your bot first)." }, "notificationLimit": { "title": "Listings per alert", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many listings an alert message lists (the count is always included).", "default": 10 }, "maxResults": { "title": "Max listings", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Listings delivered in the whole run (0 = no limit). kleinanzeigen.de shows at most 1,250 per search (50 pages); turn on Deep scan for more.", "default": 100 }, "maxResultsPerSearch": { "title": "Max per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap per keyword / URL / location when the run has several (empty = no per-search cap)." }, "maxListingsPerSeller": { "title": "Max per seller", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap per seller or PRO shop (empty = all their listings)." }, "deepScan": { "title": "Deep scan past 1,250", "type": "boolean", "description": "kleinanzeigen.de shows at most 1,250 listings per search. On = a bigger search is split by the site's own location list (states, cities, districts), then by price bands, until every slice fits.", "default": false }, "compact": { "title": "Compact rows", "type": "boolean", "description": "Core fields only (id, url, title, price, location, date, seller, image) - smaller rows for AI agents, sheets and MCP.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: the actor reads kleinanzeigen.de directly and moves to Apify datacenter, then residential proxies on its own when a route is refused. Set a proxy here to force one.", "default": { "useApifyProxy": false } }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 16, "type": "integer", "description": "Pages read at the same time per search.", "default": 8 } } }, "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 } } } } } } } } } }