{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper — Listings, Prices & New Ads Alerts", "description": "Scrape Kleinanzeigen.de (formerly eBay Kleinanzeigen), Germany's biggest classifieds: listings for any search with price, place, date and photo count. Run it again or on a schedule for new listings and price drops since the last run. Keywords or search URLs, place + radius, price range. No login.", "version": "0.1", "x-build-id": "OA1xwi8ko1LLXJpG1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-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/northbell~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-northbell-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/northbell~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-northbell-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", "required": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "One search per line: keywords such as \"iphone 15\", or the address of a Kleinanzeigen results page (https://www.kleinanzeigen.de/s-fahrraeder/c217, a category page, or any search you set up on the site). Place, price and seller filters below apply to keywords; an address is used as given.", "items": { "type": "string" } }, "location": { "title": "Place (optional)", "type": "string", "description": "A German city or a 5-digit postal code, for example Berlin or 80331. Applies to keyword searches. Leave empty to search all of Germany." }, "radiusKm": { "title": "Radius around the place (km)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How far around the place to look. 0 (the default) means the place itself only. Used only together with a place.", "default": 0 }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this amount. Applies to keyword searches. Leave empty for no lower limit." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this amount. Applies to keyword searches. Leave empty for no upper limit." }, "maxListingsPerSearch": { "title": "Listings to read per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many listings to read for each search, newest first, 25 per page. Kleinanzeigen shows at most 1,250 results per search, so 1,000 is the most you can ask for. With \"Only new or price-changed listings\" switched on, this is how deep to look; only the new or changed ones are returned and charged.", "default": 100 }, "onlyNew": { "title": "Only new or price-changed listings", "type": "boolean", "description": "Return only listings you have not seen in an earlier run of this search, plus listings whose price changed. The first run of a search has nothing to compare with and returns everything it read. Good for scheduled alerts.", "default": false }, "adType": { "title": "Offers or wanted ads", "enum": [ "offers", "wanted", "all" ], "type": "string", "description": "Kleinanzeigen has offers (for sale) and wanted ads (\"Gesuch\", people looking to buy). Offers only is the default. Applies to keyword searches.", "default": "offers" }, "seller": { "title": "Private or commercial sellers", "enum": [ "all", "private", "commercial" ], "type": "string", "description": "Filter by the kind of seller Kleinanzeigen shows: private persons or commercial sellers. Applies to keyword searches. No seller names are ever returned.", "default": "all" }, "includePromoted": { "title": "Include promoted (Top) ads", "type": "boolean", "description": "Kleinanzeigen puts a few paid \"Top\" ads above the date-ordered results. They are skipped by default; switch this on to return them too (flagged isPromoted, with no posting date).", "default": 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 }, "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 } } } } } } } } } }