{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper (Germany)", "description": "Scrape Kleinanzeigen.de ads from a search, a category or an ad URL. Searches above the site's 1,250-row limit are split automatically; what cannot be reached is counted in the summary. One ad is one row and one charge.", "version": "0.1", "x-build-id": "9RKBsBDF4uT0ExgND" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hexagone-data~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hexagone-data-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/hexagone-data~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-hexagone-data-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/hexagone-data~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-hexagone-data-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One search per term, as typed in the site's search box (e.g. Thermomix). The location and radius below apply to these searches.", "items": { "type": "string" } }, "location": { "title": "Location (search terms)", "type": "string", "description": "A city, a postal code or a German state, as typed on the site (e.g. Leipzig, 04109, Bayern). Empty: all of Germany. If the site does not know this place, the search is refused with the message 'location not found' rather than run on all of Germany. The site picks one place for a name: Freiburg is read as Freiburg (Elbe), not Freiburg im Breisgau. resolvedLocation in the run summary gives the place it read; use a postal code to be sure." }, "radiusKm": { "title": "Radius in km (search terms)", "minimum": 0, "maximum": 200, "type": "integer", "description": "0, 5, 10, 20, 30, 50, 100, 150 or 200, as on the site. Needs a location." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Kleinanzeigen URLs exactly as your browser shows them, filters included: a search (https://www.kleinanzeigen.de/s-berlin/klavier/k0l3331), a category (https://www.kleinanzeigen.de/s-autos/c216), or one ad (https://www.kleinanzeigen.de/s-anzeige//--). A page number in the URL is removed: the whole search is read. Seller profiles (s-bestandsliste) and shops (/pro/) are refused with a message. A remote list of URLs is not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum number of ads", "minimum": 0, "type": "integer", "description": "Stops at exactly this number across all searches. 0 = no limit on the number of ads: the run reads every search until it stops 2 minutes before its time limit, with a summary.", "default": 1000 }, "includeDetails": { "title": "Include the full details of each ad", "type": "boolean", "description": "Reads each ad's own page: full text, properties, equipment, category, status, the seller's display name and profile link, a yes/no for a phone number or e-mail written in the text, and a professional seller's address, legal notice and written contacts. This adds a paid event per page really read (see Pricing).", "default": false }, "splitLargeSearches": { "title": "Split searches above the site's limit", "type": "boolean", "description": "The site shows 1,250 rows per search at most. On: the search is split by location, attribute, category and price; what cannot be reached is counted in the summary. Off: it stops at 1,250 rows and the summary says how many are missing.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Replaces the automatic ladder (no proxy, then Apify datacenter proxy, then German residential proxy, only when the site refuses). Turning the proxy off is respected. With a residential proxy, a group we do not know or your own proxy URLs, ads are read in the site's lighter page: createdDate, sellerWebsite and imprint stay null." } } }, "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 } } } } } } } } } }