{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper - Listings, Prices & New Ads Alert", "description": "Kleinanzeigen scraper and API: listings by keyword or any search URL with price, VB, location, date, shipping, seller type and photos, optional full details, plus new ads alerts and price drops since your last run. Pay per listing.", "version": "1.0", "x-build-id": "6z4AoMwXSDd9jGORJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-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/kamerozkan~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-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/kamerozkan~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-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": { "searches": { "title": "Search terms", "type": "array", "description": "What you would type into the Kleinanzeigen search box, one per line, for example \"fahrrad\", \"iphone 15\" or \"wohnung\". Each search reads up to 25 listings per page, newest first.", "items": { "type": "string" } }, "location": { "title": "Location (city or postal code)", "type": "string", "description": "Limit the search terms to a city or 5-digit postal code, for example \"Berlin\", \"München\" or \"50667\". Leave empty for all of Germany." }, "radiusKm": { "title": "Radius around the location (km)", "minimum": 5, "maximum": 200, "type": "integer", "description": "Distance around the location, as on the website: 5, 10, 20, 30, 50, 100, 150 or 200 km. Only used with a location." }, "minPrice": { "title": "Min price (EUR)", "type": "integer", "description": "Only listings from this price. Applied on Kleinanzeigen for search terms and again on every row, so start URLs are filtered too. Leave empty for no limit." }, "maxPrice": { "title": "Max price (EUR)", "type": "integer", "description": "Only listings up to this price. Leave empty for no limit." }, "startUrls": { "title": "Search URLs (optional)", "type": "array", "description": "Any Kleinanzeigen search result URL copied from your browser, with category, location, radius, price or other filters already set, for example https://www.kleinanzeigen.de/s-berlin/fahrrad/k0l3331r10. Pages are followed automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItemsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 1250, "type": "integer", "description": "How many listings to read for each search term or URL (25 per page, up to 50 pages).", "default": 100 }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Open every listing page and add the full description, attributes (condition, type, size, mileage, rooms and so on), category path, seller type (private or commercial), exact posting date, coordinates and all photos. Slower (one extra page per listing); the price per listing stays the same.", "default": false }, "onlyShipping": { "title": "Only listings with shipping", "type": "boolean", "description": "Keep only listings marked \"Versand möglich\". Other listings are not saved and not charged.", "default": false }, "skipTopAds": { "title": "Skip TOP ads", "type": "boolean", "description": "Leave out the paid TOP listings that Kleinanzeigen pins above the newest results. Every row also has an isTopAd flag.", "default": false }, "monitorKey": { "title": "New ads alert key", "type": "string", "description": "Any name, for example \"bikes-berlin\". Runs with the same key remember every listing they have seen, so each row gets isNew, previousPrice and priceChange. Schedule the run every hour or day for a new ads alert. Leave empty for a plain search." }, "onlyNew": { "title": "Only new listings and price drops", "type": "boolean", "description": "With a new ads alert key: save (and pay for) only listings not seen in earlier runs, plus known listings whose price dropped. The first run saves everything it finds.", "default": false }, "maxItems": { "title": "Max listings in total", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many listings across all searches. You are charged per listing, so this also caps the cost of the run.", "default": 500 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default; if a page is refused, the request is retried through German residential proxies. Proxy traffic is included in the price.", "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 } } } } } } } } } }