{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper 💚", "description": "Collect Kleinanzeigen search listings with prices, images, locations, seller details, and listing attributes. Keep website search filters, set result limits, and export structured data through datasets, API workflows, schedules, and integrations.", "version": "1.0", "x-build-id": "bcJRc1jOPg5MEA9Gx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-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/epicscrapers~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-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/epicscrapers~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Kleinanzeigen search-result URLs, one per line. Each URL is a separate search.", "items": { "type": "string", "pattern": "^(https?://)?(www\\.)?kleinanzeigen\\.de/s-.+" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Search terms, one per line, for example “ThinkPad” or “Bugaboo Fox”.", "items": { "type": "string" } }, "category": { "title": "Category", "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", "409", "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 search to one category.", "default": "" }, "locations": { "title": "Locations", "type": "array", "description": "Cities, districts or ZIP codes, for example “Berlin”, “Hamburg-Altona” or “80331”. Leave empty to search all of Germany.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius around location", "minimum": 0, "maximum": 200, "type": "integer", "description": "Include listings up to this distance from each location. Leave empty for the location itself." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest listing price." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest listing price." }, "sellerType": { "title": "Seller", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Who is selling.", "default": "all" }, "adType": { "title": "Listing type", "enum": [ "all", "offer", "wanted" ], "type": "string", "description": "Items for sale, or ads from people looking for something.", "default": "all" }, "shipping": { "title": "Shipping", "enum": [ "all", "yes", "no" ], "type": "string", "description": "Whether the seller ships the item.", "default": "all" }, "buyNowOnly": { "title": "Direkt kaufen only", "type": "boolean", "description": "Only listings you can buy directly with Kleinanzeigen's buyer protection.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "newest", "cheapest", "mostExpensive", "recommended", "nearest" ], "type": "string", "description": "Order of the results. Matters when the maximum cuts the list short.", "default": "newest" }, "maxItems": { "title": "Maximum listings per search", "minimum": 1, "type": "integer", "description": "Stop each search after this many listings. Every URL, and every keyword and location pair, is one search.", "default": 100 }, "includeDetails": { "title": "Full listing details", "type": "boolean", "description": "Load each listing's own page data: the full description (search results cut it short), the seller's name, member-since date and when the ad was last edited. Turn off for faster runs with shortened descriptions.", "default": true }, "onlyNewListings": { "title": "Only new listings (monitor)", "type": "boolean", "description": "Save only listings this task has not saved before. The first run saves everything it finds. Needs a saved task: schedule it to get new ads every few minutes or hours.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for Kleinanzeigen requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } } }, "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 } } } } } } } } } }