{
"openapi": "3.0.1",
"info": {
"title": "Kleinanzeigen Scraper - alle Kategorien, 1000/Min",
"description": "Kleinanzeigen Scraper für alle Kategorien: 78 Felder pro Inserat mit Verkäuferdaten, Bewertung und Shop-Kontakt, 1.000 Inserate pro Minute. Such-URL einfügen, alle Filter werden übernommen. Auch über 10.000 Treffer. Monitor-Modus liefert nur neue Inserate.",
"version": "0.0",
"x-build-id": "O8H1ZqbZCZSDUSsNi"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/clearpath~kleinanzeigen-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-clearpath-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/clearpath~kleinanzeigen-scraper/runs": {
"post": {
"operationId": "runs-sync-clearpath-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/clearpath~kleinanzeigen-scraper/run-sync": {
"post": {
"operationId": "run-sync-clearpath-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": {
"startUrls": {
"title": "Such- oder Anzeigen-URLs",
"maxItems": 150,
"type": "array",
"description": "Adressen von kleinanzeigen.de: eine Suche in beliebiger Kategorie mit allen Filtern (Marke, Modell, Kilometer, Preis, Anbietertyp, Ort und Umkreis, Suchbegriff, Sortierung) oder eine einzelne Anzeige. Jede Suche läuft für sich bis Max. Ergebnisse; ein Inserat, das zwei Suchen finden, wird einmal gespeichert. Sind URLs angegeben, werden die Suchfelder unten ignoriert. Bis zu 100 Such-URLs pro Lauf.",
"items": {
"type": "string"
}
},
"maxResults": {
"title": "Max. Ergebnisse pro Suche",
"minimum": 0,
"type": "integer",
"description": "Höchstzahl gespeicherter Inserate für jede Such-URL bzw. Suche. 0 speichert alle erreichbaren Treffer (über 99 %), auch bei Suchen mit mehr als 10.000 Ergebnissen. Anzeigen-URLs werden vollständig gelesen und zählen nicht mit.",
"default": 0
},
"includeSellerDetails": {
"title": "Verkäufer- und Shopdaten",
"type": "boolean",
"description": "Ergänzt jede Zeile um Follower und Inseratszahlen des Verkäufers und, bei Verkäufern mit Shop, Website, Telefonnummern, Adresse und Öffnungszeiten des Shops.",
"default": true
},
"category": {
"title": "Kategorie",
"enum": [
"210",
"216",
"223",
"211",
"217",
"305",
"306",
"276",
"280",
"220",
"241",
"195",
"199",
"402",
"196",
"275",
"197",
"277",
"207",
"208",
"205",
"203",
"403",
"238",
"198",
"80",
"91",
"93",
"246",
"239",
"89",
"90",
"84",
"86",
"82",
"81",
"88",
"87",
"153",
"224",
"154",
"159",
"160",
"158",
"156",
"157",
"155",
"161",
"172",
"226",
"245",
"176",
"408",
"279",
"278",
"228",
"225",
"173",
"409",
"285",
"407",
"175",
"227",
"405",
"406",
"168",
"130",
"138",
"134",
"136",
"132",
"135",
"139",
"133",
"283",
"243",
"313",
"17",
"236",
"22",
"19",
"258",
"21",
"237",
"25",
"20",
"23",
"18",
"102",
"118",
"111",
"114",
"110",
"105",
"107",
"125",
"123",
"247",
"117",
"109",
"185",
"232",
"248",
"187",
"282",
"240",
"191",
"249",
"233",
"234",
"230",
"250",
"189",
"242",
"73",
"76",
"281",
"284",
"77",
"79",
"78",
"74",
"75",
"231",
"286",
"254",
"287",
"252",
"255",
"257",
"251",
"256",
"297",
"288",
"289",
"290",
"293",
"291",
"292",
"294",
"295",
"296",
"298",
"272",
"273",
"274",
"192",
"235",
"269",
"260",
"265",
"263",
"264",
"262",
"268",
"261",
"271",
"267",
"266",
"270",
"400",
"401"
],
"type": "string",
"description": "Die zu durchsuchende Kategorie. Leer lassen, um alle Kategorien zu durchsuchen."
},
"keyword": {
"title": "Suchbegriff",
"type": "string",
"description": "Wörter, die das Inserat enthalten muss, wie im Suchfeld auf kleinanzeigen.de."
},
"location": {
"title": "Ort",
"type": "string",
"description": "Stadt, PLZ oder Bundesland, z. B. Berlin oder 80331. Leer lassen für ganz Deutschland."
},
"radius": {
"title": "Umkreis",
"minimum": 0,
"type": "integer",
"description": "Entfernung um den Ort. Braucht einen Ort."
},
"minPrice": {
"title": "Mindestpreis",
"minimum": 0,
"type": "integer",
"description": "Niedrigster Angebotspreis. Inserate ohne Preis fallen weg, sobald eine Preisgrenze gesetzt ist, wie auf der Website."
},
"maxPrice": {
"title": "Höchstpreis",
"minimum": 0,
"type": "integer",
"description": "Höchster Angebotspreis."
},
"posterType": {
"title": "Anbieter",
"enum": [
"ALL",
"PRIVATE",
"COMMERCIAL"
],
"type": "string",
"description": "Nur private oder nur gewerbliche Anbieter (Händler, Shops).",
"default": "ALL"
},
"adType": {
"title": "Anzeigentyp",
"enum": [
"ALL",
"OFFERED",
"WANTED"
],
"type": "string",
"description": "kleinanzeigen.de zeigt Angebote und Gesuche gemeinsam; wähle eins, um die Suche einzugrenzen.",
"default": "ALL"
},
"filters": {
"title": "Kategoriefilter",
"type": "object",
"description": "Die eigenen Filter der gewählten Kategorie, wie auf kleinanzeigen.de. Namen mit oder ohne Kategorie-Präfix. Beispiel für Autos: {\"marke\": \"bmw\", \"model\": \"3er\", \"km\": \"0,150000\", \"ez\": \"2018,\", \"fuel\": \"diesel\", \"shift\": \"automatik\", \"navi\": true}. Bereiche schreibst du min,max, eine Seite darf leer bleiben. Ein Filter, den die Kategorie nicht hat, stoppt den Lauf mit einer Liste der vorhandenen Filter, damit nie ohne ihn gesucht wird."
},
"sorting": {
"title": "Sortierung",
"enum": [
"newest",
"price_asc",
"price_desc",
"distance"
],
"type": "string",
"description": "Reihenfolge, in der Inserate gesammelt werden. Gilt auch für URLs ohne eigene Sortierung.",
"default": "newest"
},
"monitorMode": {
"title": "Monitor-Modus",
"type": "boolean",
"description": "Speichert nur Inserate, die seit dem letzten Lauf derselben Suche neu sind. Der erste Lauf merkt sich den Bestand und speichert nichts. Kombiniere ihn mit einem Zeitplan.",
"default": false
},
"telegramUserId": {
"title": "Telegram-Nutzer-ID",
"type": "string",
"description": "Deine numerische Telegram-Nutzer-ID, für eine Nachricht pro neuem Inserat. Schreib @userinfobot auf Telegram, um sie zu erhalten."
},
"telegramNotificationLimit": {
"title": "Telegram-Limit",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Höchstzahl an Telegram-Nachrichten pro Lauf.",
"default": 10
},
"feedback": {
"title": "Feedback to the maintainers",
"type": "string",
"description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}