{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Listings Scraper", "description": "Kleinanzeigen Scraper SD - Kleinanzeigen Scraper is a classifieds data tool that extracts kleinanzeigen.de ads by keyword or browser URL: title, price, VB and free flags, location, date, images, seller type and shop, page after page, plus optional full ad details.", "version": "1.0", "x-build-id": "Kfek3oK0RgOptHgS1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuro-scraper~kleinanzeigen-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuro-scraper-kleinanzeigen-listings-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/neuro-scraper~kleinanzeigen-listings-scraper/runs": { "post": { "operationId": "runs-sync-neuro-scraper-kleinanzeigen-listings-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/neuro-scraper~kleinanzeigen-listings-scraper/run-sync": { "post": { "operationId": "run-sync-neuro-scraper-kleinanzeigen-listings-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What you would type in the Kleinanzeigen search box, one term per line. Searches all of Germany. Example: fahrrad", "items": { "type": "string" } }, "startUrls": { "title": "Kleinanzeigen URLs (optional)", "type": "array", "description": "Search, category or filtered result URLs copied from the browser (location, radius, category, price and sort are kept), e.g. https://www.kleinanzeigen.de/s-fahrraeder/berlin/fahrrad/k0c217l3331r10 - and single ad URLs (.../s-anzeige//<id>-<cat>-<loc>), which return that ad with all details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of ads to return in total. Result pages are read one after another until this number is reached or the search has no further page. Example: 100", "default": 20 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Safety limit on result pages per search term or URL. Kleinanzeigen itself shows at most 50 pages (about 1,250 ads) per search - narrow the search by category, location or price for more. Example: 10", "default": 50 }, "sortBy": { "title": "Sort search terms by", "enum": [ "newest", "priceAsc", "priceDesc" ], "type": "string", "description": "Order of the results for the search terms above (start URLs keep the sort they carry).", "default": "newest" }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Only ads from this price, for the search terms above. Example: 100" }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Only ads up to this price, for the search terms above. Example: 500" }, "includeTopAds": { "title": "Include top ads", "type": "boolean", "description": "Kleinanzeigen shows about 2 paid \"top ads\" at the head of every result page; they are older ads moved to the top. Turn off to keep only the regular results (each row has isTopAd either way).", "default": true }, "includeDetails": { "title": "Include ad details", "type": "boolean", "description": "Open every ad page and add the full description, attributes (e.g. Zustand, Wohnfläche), features, category, region and coordinates, creation date and the seller's public profile (name, since, badges, active ads). Costs 1 extra request per ad, so runs are slower.", "default": false }, "includeViewCount": { "title": "Include view count", "type": "boolean", "description": "With ad details on: also read the ad's view counter (1 more request per ad - the same counter call the ad page makes in a browser, so it counts as one visit).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy in Germany is recommended for larger runs (Kleinanzeigen uses Akamai bot protection) and is the default.", "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 } } } } } } } } } }