{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper [$0.39/1K 💰] — All Categories", "description": "$0.39 per 1,000 listings — the lowest-priced Kleinanzeigen scraper on the Store. Every category: electronics, cars, furniture, collectables, property. Returns price type, postcode, images and attributes, with a private-seller filter. Same field names as our Marktplaats and 2dehands scrapers.", "version": "0.0", "x-build-id": "bZZuLOm0hsNZe9qyx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~kleinanzeigen-classifieds-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-kleinanzeigen-classifieds-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/unfenced-group~kleinanzeigen-classifieds-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-kleinanzeigen-classifieds-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/unfenced-group~kleinanzeigen-classifieds-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-kleinanzeigen-classifieds-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": { "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword to search for, in German. Example: \"pokemon karten\" for trading cards, \"wohnung mieten\" for rental flats. Leave empty to browse a whole category instead." }, "categoryId": { "title": "Category", "enum": [ "", "210", "216", "223", "211", "217", "305", "306", "276", "280", "220", "297", "288", "289", "290", "293", "291", "292", "294", "295", "296", "298", "231", "286", "254", "287", "252", "255", "257", "251", "256", "17", "236", "22", "19", "258", "21", "237", "25", "20", "23", "185", "232", "248", "187", "282", "240", "191", "249", "233", "234", "230", "250", "189", "80", "91", "93", "246", "239", "89", "90", "84", "86", "82", "81", "88", "130", "138", "134", "136", "132", "135", "139", "133", "283", "243", "313", "195", "199", "402", "196", "275", "197", "277", "207", "208", "205", "203", "403", "238", "102", "118", "111", "114", "110", "105", "107", "125", "123", "247", "117", "109", "153", "224", "154", "159", "160", "158", "156", "157", "161", "172", "226", "245", "173", "176", "279", "278", "225", "228", "285", "175", "227", "405", "406", "73", "76", "281", "284", "77", "79", "78", "74", "400", "401", "235", "269", "260", "265", "263", "264", "262", "268", "261", "271", "267", "266", "270", "272", "273", "274", "192" ], "type": "string", "description": "Restrict the search to one kleinanzeigen category. Leave as \"All categories\" to search the whole site. Combine with a search query to search within a category.", "default": "" }, "location": { "title": "Location", "type": "string", "description": "German town, city, district or federal state to search in — for example \"Berlin\", \"München\", \"Nordrhein-Westfalen\". Postcodes are not accepted here; use a place name. Leave empty to search all of Germany.", "default": "" }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount in euros. Listings with no numeric price (\"VB\" with no figure, or price only in the description) are excluded when this is set." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount in euros. Listings with no numeric price are excluded when this is set." }, "daysOld": { "title": "Listed within (days)", "minimum": 1, "type": "integer", "description": "Only return listings published within this many days. 1 means today only. Leave empty for listings of any age." }, "sellerType": { "title": "Seller type", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Filter by who is selling. \"private\" returns only private sellers, which is where under-priced and one-off items are found; \"commercial\" returns only dealers and shops; \"all\" returns both. Applied by kleinanzeigen itself, not after the fact. Requires a search query or a category alongside it, and reaches about 135 listings per search.", "default": "all" }, "maxItems": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many listings. Set to 0 for no limit. Kleinanzeigen caps any one search at roughly 1,250 listings (50 pages), or about 135 when filtering by seller type.", "default": 100 }, "fetchDetails": { "title": "Fetch listing details", "type": "boolean", "description": "Open each listing page to add the full description, the exact publish date, the condition and item-type attributes, all gallery images, and the seller type. Roughly fourteen times slower and fourteen times more traffic per listing.", "default": false }, "startUrls": { "title": "Start URLs (overrides all filters)", "type": "array", "description": "Kleinanzeigen search or category URLs to scrape directly, for example https://www.kleinanzeigen.de/s-pokemon-karten/k0. Each URL is paginated automatically. When set, every filter above except Maximum results is ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. This scraper runs without a proxy by default because kleinanzeigen does not block datacenter IPs — it only throttles them, and the scraper retries with backoff. Enable a proxy only if you see persistent throttling.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }