{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper - Search & New Listing Alerts", "description": "Enter Kleinanzeigen.de keywords or search URLs and get one row per listing: title, price, price type, postcode, city, posted time, shipping, image and URL. Can return only listings that are new since the last run. No seller personal data.", "version": "0.1", "x-build-id": "gOtIudBb2o7hkD7Wq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/magenta_courser~kleinanzeigen-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-magenta_courser-kleinanzeigen-monitor", "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/magenta_courser~kleinanzeigen-monitor/runs": { "post": { "operationId": "runs-sync-magenta_courser-kleinanzeigen-monitor", "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/magenta_courser~kleinanzeigen-monitor/run-sync": { "post": { "operationId": "run-sync-magenta_courser-kleinanzeigen-monitor", "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", "required": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "Keywords (e.g. \"iphone 13\", \"fahrrad\", \"lego technic\") or full Kleinanzeigen search URLs copied from your browser (e.g. https://www.kleinanzeigen.de/s-fahrraeder/c217). One per line. Each search returns at most 1,250 listings (50 pages), the site's own limit.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 1250, "type": "integer", "description": "Maximum listings to save for each search, newest first. Kleinanzeigen shows at most 1,250 per search; split large searches by price, category or location to get more.", "default": 100 }, "onlyNewSinceLastRun": { "title": "Only new listings since the last run", "type": "boolean", "description": "Return only listings not returned by an earlier run of the same search (same keyword and filters). The first run returns the current listings and remembers them. Ideal for scheduled runs (e.g. every hour).", "default": false }, "historyStoreName": { "title": "History store name", "type": "string", "description": "Name of the key-value store that remembers seen listings for \"Only new listings\". Use different names for independent monitors. Lowercase letters, digits and dashes.", "default": "kleinanzeigen-monitor-history" }, "includeDetails": { "title": "Include listing details (charged separately)", "type": "boolean", "description": "Open each listing page to add the full description, attributes (brand, model, condition, size, ...) and shipping cost. One extra request per listing, so slower and charged as a separate event.", "default": false }, "category": { "title": "Category", "type": "string", "description": "Optional. Kleinanzeigen category ID (e.g. 173 = Smartphones, 217 = Fahrräder & Zubehör, 23 = Spielzeug, 161 = Elektronik), its URL name (e.g. handy-telekom) or German name. Applies to keyword searches only." }, "location": { "title": "Location (postcode or city)", "type": "string", "description": "Optional. German postcode (e.g. 10115) or city name (e.g. Berlin, München). Applies to keyword searches only." }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius around the location. Kleinanzeigen supports 5, 10, 20, 30, 50, 100, 150 and 200 km; other values are rounded to the nearest one. Ignored without a location." }, "minPrice": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Only listings at or above this price. Applies to keyword searches only." }, "maxPrice": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Only listings at or below this price. Applies to keyword searches only." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Kleinanzeigen often refuses datacenter IPs. German residential proxy is the default and recommended.", "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 } } } } } } } } } }