{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen.de Scraper: eBay Kleinanzeigen Ads", "description": "Scrape Kleinanzeigen.de (formerly eBay Kleinanzeigen) ads by keyword, category, location, seller or search URL: title, price, description preview, photos, GPS location, seller type and posting date. Monitor new ads on a schedule. Export JSON, CSV or Excel.", "version": "0.0", "x-build-id": "dgPmdyrrILHNDFPOD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~kleinanzeigen-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-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/nice_dev~kleinanzeigen-listings-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-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/nice_dev~kleinanzeigen-listings-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Kleinanzeigen search-result URLs (`https://www.kleinanzeigen.de/s-fahrrad/k0`, pagination is automatic), seller pages (`https://www.kleinanzeigen.de/s-bestandsliste.html?userId=123745993`) or single listing URLs (`https://www.kleinanzeigen.de/s-anzeige/mein-fahrrad/3516612023-217-9212`). A pasted search keeps the search, the filters and the sort written in its URL: when this list is not empty, the search fields below (keyword, category, location, sellers, shops) AND the **Site filters** are ignored (the log names them) — set those on the site before copying the URL. The other filters (dates, excluded keywords, photos…), the caps and monitoring still apply. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search keyword", "maxLength": 200, "type": "string", "description": "Free-text search, exactly as typed on the site (e.g. `fahrrad`). Empty = every listing of the chosen category / location." }, "searchQueries": { "title": "More search keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each location below). Added to **Search keyword**; listings found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "maxLength": 100, "type": "string", "description": "Category name as on the site (`Fahrräder & Zubehör`), its URL slug (`Fahrraeder`, `c217`) or its numeric id (`217`). Empty = all categories. Subcategories are included." }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "City, district or postcode as typed on the site (e.g. `Berlin`, `10115`), or the site's own id (`l3331`). A name several places share gives the place of that name, the biggest one if several (`Hagen` = Hagen in NRW, not Hagen im Bremischen; `Frankfurt` = Frankfurt am Main; the log names the others — type the full name, `Frankfurt (Oder)`, to choose another). Empty = whole Germany." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: every keyword is searched in every location (3 keywords × 4 locations = 12 searches, max 500). Added to **Location**.", "default": [], "items": { "type": "string" } }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Radius of a circle around the centre of each location. 0 = the location as the site defines it. Inside a big city a small radius returns FEWER ads than 0 (Berlin: 24,900 ads with 10 km against 34,600 with 0). Ignored when no location is given.", "default": 0 }, "sellerIds": { "title": "Seller ids or URLs", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Every ad of these sellers: numeric user id (`123745993`) or seller-page URL (`https://www.kleinanzeigen.de/s-bestandsliste.html?userId=123745993`). Each seller counts as one search (its own per-search cap); the category, the filters and the first keyword and first location of the input still apply to it.", "default": [], "items": { "type": "string" } }, "storeIds": { "title": "Shop ids or URLs", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Every ad of these commercial shops: the numeric shop id this Actor returns for a commercial ad (a shop page URL carries no id). Same rules as seller ids.", "default": [], "items": { "type": "string" } }, "listingIds": { "title": "Listing ids or URLs", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Fetch these listings directly, by id (`3516612023`) or by URL. Always added to the searches above; each id costs one request and is not affected by the site filters. Such a listing is always read on its own page, so it is charged the **Extract details** price even when that box is off.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to save for the whole run (after deduplication and filters). 0 = no limit.", "default": 100 }, "maxItemsPerQuery": { "title": "Max listings per search", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap for EACH search (keyword × location, seller, shop or search URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap. The site itself never returns more than 10 000 listings per search.", "default": 0 }, "extractDetails": { "title": "Extract details", "type": "boolean", "description": "Open each listing (1 extra request per listing) for the full description, the seller's name, registration date, rating and badges, the shop imprint and e-mail, the street, the phone number when the seller published one, the shipping price, and whether a price offer and secure payment are possible. Charged as an option on top of the listing (see Pricing). Off (the default) = listing-card fields only (≈ 100 listings per request, much faster, and cheaper: no Details charge). **With phone number only** needs it on.", "default": false }, "minPrice": { "title": "Min price (€)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Lowest price. With **Min price** or **Max price** set, even `0`, the site drops the listings that show no amount (`VB` without a price, most wanted ads); a free giveaway counts as 0 €." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Highest price. Set, it drops the listings that show no amount too (see **Min price**)." }, "sellerType": { "title": "Seller type", "enum": [ "ANY", "PRIVATE", "COMMERCIAL" ], "type": "string", "description": "Keep private sellers only, commercial sellers only, or both.", "default": "ANY" }, "adType": { "title": "Ad type", "enum": [ "ANY", "OFFERED", "WANTED" ], "type": "string", "description": "Offers, the site's Angebote — or wanted ads, its Gesuche — or both.", "default": "ANY" }, "pictureRequired": { "title": "With photo only", "type": "boolean", "description": "Keep only the listings that have at least one photo.", "default": false }, "buyNowOnly": { "title": "Buy now only", "type": "boolean", "description": "Keep only the listings that can be bought directly (`Direkt kaufen`).", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "DATE_DESCENDING", "PRICE_ASCENDING", "PRICE_DESCENDING", "DISTANCE_ASCENDING" ], "type": "string", "description": "Order in which the site returns the listings. Newest first is the default and the one used to stop early on **Posted after** / **Only new listings**.", "default": "DATE_DESCENDING" }, "attributeFilters": { "title": "Category attributes", "type": "object", "description": "Per-category filters of the site, as `attribute: value`. The attribute names are the `name` of each entry of `attributeList` in the output — not the German labels of `attributes` (e.g. `autos.marke`: `volvo`, `autos.model`: `v40`, `autos.fuel`: `diesel`, `autos.navi`: `true`). Numbers and dates take a range `min,max` with open ends allowed: `autos.km`: `,50000`, `autos.power`: `100,200`, `autos.ezdate`: `2015-01,2020-12`. Needs a category that owns the attribute; one value per attribute.", "default": {} }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only listings published on or after this date: `2026-09-01`, a full ISO date-time, or a period before now such as `24 hours`, `7 days`, `2 weeks`, `1 month`. The site gives the publication time to the second, so a run every hour with `1 hour` returns exactly the new ads." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only listings published on or before this date (the whole day is included), or older than a period such as `30 days`." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the listings whose title or description contains one of these words (case and German umlauts ignored; a word inside a longer one counts: `rad` drops `Fahrrad`). Without **Extract details** the description is the short preview of the card.", "default": [], "items": { "type": "string" } }, "priceTypes": { "title": "Price types", "uniqueItems": true, "type": "array", "description": "Keep only these kinds of price: a fixed amount, negotiable (VB, with or without an amount), or free (Zu verschenken). Empty = all. Checked on each listing; a listing it drops is charged as a filter check.", "items": { "type": "string", "enum": [ "SPECIFIED_AMOUNT", "PLEASE_CONTACT", "FREE" ], "enumTitles": [ "Fixed amount", "Negotiable (VB)", "Free (Zu verschenken)" ] }, "default": [] }, "requirePhone": { "title": "With phone number only", "type": "boolean", "description": "Keep only the listings whose seller published a phone number (≈ 69 % of commercial sellers, ≈ 4 % of private ones). Needs **Extract details**. The phone is only on the listing's own page: each page read, then dropped for lack of a phone, is charged as a *Filtered listing* event (see the pricing). On private sellers, hundreds of pages can be read for few listings: the run stops after 300 pages in a row without a phone, and never goes past your maximum cost.", "default": false }, "minImages": { "title": "Min photos", "minimum": 0, "maximum": 50, "type": "integer", "description": "Drop the listings with fewer photos than this. 0 = no filter.", "default": 0 }, "shipping": { "title": "With shipping only", "type": "boolean", "description": "Keep only the listings whose seller offers shipping (`Versand möglich`).", "default": false }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged, and their page is not even opened. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `berlin-bikes`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.", "default": false }, "includeViewCount": { "title": "View count", "type": "boolean", "description": "Add how many times the listing has been viewed (`viewCount`). Costs 1 extra tiny request per listing and counts as one visit on the site, exactly like opening the page in a browser.", "default": false }, "includeRaw": { "title": "Include raw data", "type": "boolean", "description": "Add a `raw` field with the untouched JSON of the site (listing card and detail). Useful to recover a field this Actor does not map yet; makes the dataset ≈ 5× bigger.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 8 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Global request rate, for every request to the site. With **View count** on, a listing page and its view counter count as TWO requests here (the counter is a request of its own, read together with its page). Lower it if the site answers HTTP 429 / 403 in the log.", "default": 240 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. Behind a proxy, a request the site turns away is also retried on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "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 } } } } } } } } } }