{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen.de Scraper", "description": "🏷️ Free Kleinanzeigen.de scraper. Paste any search link with all its filters (cars, real estate, electronics…) or type keywords + city. Get price, location, photos, category details and optional seller info: name, rating, views and business phone numbers.", "version": "0.1", "x-build-id": "9WConnvh7Vxt1zH3S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dz_omar~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dz_omar-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/dz_omar~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-dz_omar-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/dz_omar~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-dz_omar-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": "🔗 Search or listing links", "type": "array", "description": "One link per line. Search result pages keep all their filters and sort order; a listing link returns that one listing with full details and seller info.", "items": { "type": "string", "pattern": "^https?://(www\\.)?kleinanzeigen\\.de/s-.+" } }, "searchQueries": { "title": "🔎 Search keywords", "type": "array", "description": "Each keyword runs as its own search, e.g. \"iphone 15\", \"ebike\", \"3 zimmer wohnung\".", "items": { "type": "string", "minLength": 1 } }, "category": { "title": "🗂️ Category · keyword search only", "enum": [ "", "210", "216", "223", "211", "217", "305", "306", "276", "280", "220", "241", "195", "199", "402", "196", "275", "197", "277", "207", "208", "205", "203", "403", "238", "198", "80", "91", "93", "246", "239", "89", "90", "84", "86", "82", "81", "88", "87", "153", "224", "154", "159", "160", "158", "156", "157", "155", "161", "172", "226", "245", "176", "408", "279", "278", "228", "225", "173", "285", "407", "175", "227", "405", "406", "168", "130", "138", "134", "136", "132", "135", "139", "133", "283", "243", "313", "17", "236", "22", "19", "258", "21", "237", "25", "20", "23", "18", "102", "118", "111", "114", "110", "105", "107", "125", "123", "247", "117", "109", "185", "232", "248", "187", "282", "240", "191", "249", "233", "234", "230", "250", "189", "242", "73", "76", "281", "284", "77", "79", "78", "74", "75", "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", "269", "260", "265", "263", "264", "262", "268", "261", "271", "267", "266", "270", "400", "401" ], "type": "string", "description": "Limit the keyword search to one category (main categories include all their subcategories).", "default": "" }, "location": { "title": "📍 Location · keyword search only", "type": "string", "description": "City, district or zip code, e.g. \"Hamburg\", \"München\", \"10115\". Leave empty to search all of Germany. If the place is not found, the search runs Germany-wide and the log says so." }, "radiusKm": { "title": "📍 Radius around the location · keyword search only", "enum": [ "", "5", "10", "20", "30", "50", "100", "150", "200", "500" ], "type": "string", "description": "Only used together with a location.", "default": "" }, "minPrice": { "title": "💶 Minimum price (€) · keyword search only", "minimum": 0, "type": "integer", "description": "Only listings at or above this price. Leave empty for no minimum." }, "maxPrice": { "title": "💶 Maximum price (€) · keyword search only", "minimum": 0, "type": "integer", "description": "Only listings at or below this price. Leave empty for no maximum." }, "sortBy": { "title": "↕️ Sort order · keyword search only", "enum": [ "newest", "price_asc", "price_desc", "distance", "recommended" ], "type": "string", "description": "Order in which listings are collected — matters when you cap the number of listings.", "default": "newest" }, "sellerType": { "title": "👤 Seller type · keyword search only", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Private individuals, businesses, or both.", "default": "all" }, "offerType": { "title": "🏷️ Offer type · keyword search only", "enum": [ "all", "offered", "wanted" ], "type": "string", "description": "Items offered, or \"wanted\" requests (Gesuche).", "default": "all" }, "shipping": { "title": "📦 Shipping · keyword search only", "enum": [ "all", "shippable", "pickup" ], "type": "string", "description": "Whether the seller ships the item.", "default": "all" }, "buyNowOnly": { "title": "🛒 \"Direkt kaufen\" only · keyword search only", "type": "boolean", "description": "Only listings that can be bought directly on Kleinanzeigen.", "default": false }, "photosOnly": { "title": "🖼️ With photos only · keyword search only", "type": "boolean", "description": "Skip listings without pictures.", "default": false }, "includeDetails": { "title": "📋 Include full details and seller info", "type": "boolean", "description": "Adds the full description, seller name, seller ID, rating and badges, member-since date, view count, and — for commercial sellers — phone number and imprint. Slower: one extra lookup per listing.", "default": false }, "maxResultsPerSearch": { "title": "🔢 Max listings per search", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops each link or keyword after this many listings. Above 10,000 the search is collected automatically in date ranges (Kleinanzeigen shows at most 10,000 per search), so large searches such as all used cars work too — this takes longer.", "default": 100 }, "maxResults": { "title": "🔢 Max listings in total (0 = no limit)", "minimum": 0, "type": "integer", "description": "Caps the whole run across all links and keywords.", "default": 0 } } }, "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 } } } } } } } } } }