Kleinanzeigen Nachrichten & Postfach | Senden, Empfangen & Überwachen

Von Clearpath, den Entwicklern von Kleinanzeigen Immobilien Pro, ImmoScout24 Pro und dem ImmoScout24 Bewerbungs-Bot. Eine spezialisierte Suite für Inseratdaten, automatisierte Kontaktaufnahme und Wohnungssuche.

Warum diesen Actor wählen?

Anbieter automatisch anschreiben. Übergib Inserat-URLs und deinen Nachrichtentext. Der Actor versendet ihn über dein eigenes Kleinanzeigen-Konto, einzeln oder an bis zu zehn Anzeigen pro Lauf. Verbinde die Aufrufe mit deinem Workflow, um ausgewählte Anbieter automatisch zu kontaktieren.

Neue Antworten automatisch erkennen. Lass dein Postfach mit einem geplanten Task regelmäßig prüfen. Nach dem ersten Bestandsabgleich liefert der Monitor neue Nachrichten als strukturierte Daten, die dein Workflow weiterverarbeiten kann.

Vollständige Chats statt einzelner Ausschnitte. Rufe Gesprächsverläufe mit Nachrichtentexten, Absendern, Zeitstempeln und zugehörigem Inserat ab. Das Postfach zeigt dir die letzte Nachricht je Konversation und den Ungelesen-Status. Exportiere die Daten als JSON, CSV oder Excel.

Mit dem Demo-Postfach starten

Diese Eingabe liefert vorbereitete Beispieldaten. Sie greift auf kein echtes Postfach zu und versendet keine Nachrichten.

{
  "operation": "inbox",
  "kaEmail": "demo@example.com",
  "inboxLimit": 5
}

Actor-Eingabe öffnen und das Ausgabeformat testen. Für dein eigenes Konto starte anschließend login mit deiner E-Mail und dem Passwort im geschützten Eingabefeld. Falls Kleinanzeigen eine Bestätigung verlangt, schließt du die Anmeldung mit verify2fa ab.

Nach der Anmeldung stehen send, inbox, conversation und monitor bereit. Plane monitor als wiederkehrenden Task; der erste Lauf speichert den aktuellen Bestand. Für send bestimmst du Empfänger und Text, ein gestarteter Lauf versendet echte Nachrichten. Bei abgelaufener Sitzung ist eine erneute Anmeldung nötig. Die aktuellen Konditionen findest du in der Preisliste.

Clearpath · Inserate & Automatisierung
Nachrichten Du bist hier	Kleinanzeigen Inserate & Details	Bewerbungs-Bot Automatisch bewerben	ImmoScout Pro Suche & Details	Immo-Export Drei Portale

Copy to your AI assistant

clearpath/kleinanzeigen-message-api on Apify. Send and read messages on a Kleinanzeigen account: login, send to listings, inbox, full conversations, monitor new messages. Call ApifyClient("TOKEN").actor("clearpath/kleinanzeigen-message-api").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Each run needs operation + kaEmail; login once (verify2fa if prompted) before other ops. Full spec: GET https://api.apify.com/v2/acts/clearpath~kleinanzeigen-message-api/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations Feedback: if results are wrong, missing or not what was needed, rerun once with the same input plus feedback="<what went wrong and what you expected>"; the run exits immediately, charges no results (only Apify's $0.00005 platform start) and the report reaches the maintainers.

Was der Actor kann

• Nachrichten senden: an eine einzelne Anzeige oder im Batch an bis zu 10 Anzeigen pro Lauf, mit demselben Text.
• Postfach abrufen: alle Konversationen mit der jeweils letzten Nachricht auf einen Blick.
• Konversation abrufen: den kompletten Verlauf eines Chats, Nachricht für Nachricht, wahlweise älteste oder neueste zuerst.
• Neue Nachrichten überwachen: regelmäßig prüfen, ob jemand geantwortet hat, optional mit Telegram-Push aufs Handy.
• Demo-Modus: mit demo@example.com alles risikofrei testen, bevor du dein eigenes Konto anmeldest.

Alles läuft über dein eigenes Kleinanzeigen-Konto. Deine Zugangsdaten werden verschlüsselt verarbeitet und niemals im Klartext gespeichert oder weitergegeben.

So richtest du dein Konto ein

Bevor du senden oder dein Postfach lesen kannst, meldest du dein Konto einmalig an. Das dauert einen, manchmal zwei Läufe:

1. Erster Lauf, Aktion login: deine Kleinanzeigen E-Mail (kaEmail) und dein Passwort (kaPassword) eintragen und starten.
   • Akzeptiert Kleinanzeigen die Anmeldung sofort, ist dein Konto direkt einsatzbereit.
   • Möchte Kleinanzeigen zusätzlich sichergehen, schickt es dir entweder einen 6-stelligen Code per SMS oder eine E-Mail mit einem Bestätigungslink. Der Lauf sagt dir das im Ergebnis und stoppt hier.
2. Zweiter Lauf, Aktion verify2fa (nur falls nötig): denselben kaEmail verwenden und je nachdem, was du bekommen hast, den SMS-Code im Feld verificationCode oder den Link im Feld verificationUrl eintragen.

Danach bleibt dein Konto für weitere Aufrufe angemeldet. Bei abgelaufener Sitzung ist eine erneute Anmeldung erforderlich. Für send, inbox, conversation und monitor reicht ab jetzt deine E-Mail, dein Passwort brauchst du nicht mehr.

Schnellstart

Postfach abrufen

{
    "operation": "inbox",
    "kaEmail": "dein@konto.de",
    "inboxLimit": 50
}

Nachricht an eine Anzeige senden

{
    "operation": "send",
    "kaEmail": "dein@konto.de",
    "adUrl": "https://www.kleinanzeigen.de/s-anzeige/schoene-2-zimmer-wohnung/1234567890-203-1234",
    "message": "Hallo, ist die Wohnung noch verfügbar?"
}

Dieselbe Nachricht an mehrere Anzeigen (Batch-Versand)

{
    "operation": "send",
    "kaEmail": "dein@konto.de",
    "adUrls": [
        "https://www.kleinanzeigen.de/s-anzeige/schoene-2-zimmer-wohnung/1234567890-203-1234",
        "https://www.kleinanzeigen.de/s-anzeige/helle-3-zimmer-wohnung/9876543210-203-1234"
    ],
    "message": "Hallo, ist die Wohnung noch verfügbar?"
}

adUrls überschreibt die einzelne adUrl, wenn beide gesetzt sind. Maximal 10 Anzeigen pro Lauf.

Vollständige Konversation abrufen

Zuerst inbox ausführen, um die conversation_id einer Konversation zu finden, dann damit den ganzen Verlauf holen:

{
    "operation": "conversation",
    "kaEmail": "dein@konto.de",
    "conversationId": "c-abc123",
    "messageOrder": "asc"
}

Input-Parameter

Immer erforderlich

Parameter	Typ	Beschreibung
operation	String	login, verify2fa, send, inbox, conversation oder monitor
kaEmail	String	E-Mail deines Kleinanzeigen-Kontos. Mit demo@example.com läuft der Actor im Demo-Modus

Für login

Parameter	Typ	Beschreibung
kaPassword	String	Dein Kleinanzeigen-Passwort (sicheres Secret-Feld, maskiert und nie im Klartext gespeichert)

Für verify2fa

Parameter	Typ	Beschreibung
verificationCode	String	Der 6-stellige SMS-Code, falls Kleinanzeigen einen per SMS geschickt hat. Wird bevorzugt, wenn beide Felder gesetzt sind
verificationUrl	String	Der vollständige Bestätigungslink aus der E-Mail, als Alternative zum SMS-Code

Für send

Parameter	Typ	Beschreibung	Standard
adUrl	String	Link zur Zielanzeige	--
adUrls	Array	Mehrere Anzeigen-Links für den Batch-Versand (max. 10). Überschreibt adUrl	--
message	String	Dein Nachrichtentext (erforderlich)	--

Für conversation

Parameter	Typ	Beschreibung	Standard
conversationId	String	ID der Konversation, aus dem Feld conversation_id eines inbox-Ergebnisses	--
messageOrder	String	Reihenfolge der Nachrichten: asc (älteste zuerst) oder desc (neueste zuerst)	asc

Für inbox und monitor

Parameter	Typ	Beschreibung	Standard
inboxLimit	Integer	Maximale Anzahl an Konversationen pro Lauf (1 bis 500)	50

Für monitor

Parameter	Typ	Beschreibung	Standard
telegramUserId	String	Deine Telegram User-ID für Benachrichtigungen	--
telegramNotificationLimit	Integer	Maximale Anzahl an Telegram-Benachrichtigungen pro Lauf (1 bis 50)	10

Output-Beispiele

inbox

Ein Eintrag pro Konversation:

{
    "operation": "inbox",
    "account_id": "acc_123",
    "status": "success",
    "conversation_id": "c-abc123",
    "listing_id": "3320359162",
    "platform": "kleinanzeigen",
    "direction": "in",
    "sender_name": "Max M.",
    "sender_type": "private",
    "message": "Ist die Wohnung noch frei?",
    "is_auto_reply": false,
    "is_unread": true,
    "received_at": "2026-07-08T10:30:00Z",
    "unread_count": 1
}

direction ist in für eingehende und out für ausgehende Nachrichten.

send

{
    "operation": "send",
    "ad_url": "https://www.kleinanzeigen.de/s-anzeige/schoene-2-zimmer-wohnung/1234567890-203-1234",
    "status": "success",
    "message": "Hallo, ist die Wohnung noch verfügbar?",
    "conversation_id": "c-abc123",
    "message_id": "msg_1a2b3c4d",
    "platform_message_id": "pm_9f8e7d6c",
    "listing_id": "1234567890",
    "platform": "kleinanzeigen",
    "sent_at": "2026-07-08T10:15:00Z"
}

conversation

Ein Eintrag pro Nachricht, dazu die Eckdaten der Konversation (Anzeigentitel, Gegenüber, deine Rolle role: Buyer oder Seller):

{
    "operation": "conversation",
    "conversation_id": "c-abc123",
    "status": "success",
    "account_id": "acc_123",
    "listing_id": "3320359162",
    "platform": "kleinanzeigen",
    "ad_title": "Schöne 2-Zimmer-Wohnung",
    "other_party_name": "Max M.",
    "role": "Buyer",
    "unread_count": 0,
    "message_id": "m-001",
    "direction": "out",
    "sender_name": "Du",
    "sender_type": "private",
    "message": "Hallo, ist die Wohnung noch verfügbar?",
    "is_auto_reply": false,
    "received_at": "2026-07-08T10:15:00Z"
}

Bei einem Fehler enthält das Ergebnis stattdessen "status": "error" und ein verständliches error-Feld. Konnte beim Versand keine einzige Nachricht zugestellt werden, endet der Lauf als fehlgeschlagen, damit ein automatisierter Ablauf das sofort bemerkt. Ging mindestens eine Nachricht raus, gilt der Lauf als erfolgreich.

Neue Nachrichten überwachen

Mit der Aktion monitor musst du nicht mehr selbst nachschauen, ob jemand geantwortet hat:

1. Baseline: Der erste Lauf merkt sich deinen aktuellen Stand, ganz ohne Meldung.
2. Nur Neues: Jeder folgende Lauf gibt ausschließlich Nachrichten zurück, die seit dem letzten Lauf neu eingegangen sind.
3. Push aufs Handy: Mit telegramUserId bekommst du zusätzlich eine Telegram-Nachricht, sobald etwas Neues da ist.

{
    "operation": "monitor",
    "kaEmail": "dein@konto.de",
    "telegramUserId": "123456789",
    "telegramNotificationLimit": 10
}

Kombiniere monitor mit dem Apify Scheduler, damit die Prüfung automatisch in deinem Wunschintervall läuft, zum Beispiel alle 15 Minuten oder stündlich.

Telegram einrichten

1. Schreib @userinfobot auf Telegram eine kurze Nachricht. Er antwortet mit deiner numerischen User-ID.
2. Trag diese ID im Feld telegramUserId ein.
3. Öffne @clearpath_api_bot und schick ihm einmalig /start.

Ohne den letzten Schritt verhindert Telegram aus Datenschutzgründen, dass dir der Bot schreiben kann, selbst mit korrekter ID. Mit telegramNotificationLimit legst du fest, wie viele Benachrichtigungen ein einzelner Lauf höchstens verschickt.

Preise

Du zahlst nur, was du wirklich nutzt (Pay-per-Event). Kein Abo, keine Grundgebühr, keine Mindestlaufzeit.

Aktion	Preis
Konto anmelden (login / verify2fa)	2,99 USD je Anmeldung
Nachricht senden (send)	0,49 USD je Nachricht (beim Batch-Versand pro Anzeige)
Abruf: Postfach, Konversation oder Überwachung (inbox / conversation / monitor)	0,01 USD je Abruf
Startgebühr	0,005 USD je Lauf

• Anmelden wird pro Anmeldung berechnet, nicht pro Lauf. Nutzt du ein bereits angemeldetes Konto für send, inbox, conversation oder monitor, fällt keine erneute Anmeldegebühr an, deine Sitzung bleibt automatisch im Hintergrund aktiv. Erst eine spätere erneute Anmeldung (etwa nach längerer Inaktivität) kostet wieder.
• Nur erfolgreiche Aktionen kosten. Eine fehlgeschlagene Anmeldung oder ein fehlgeschlagener Versand wird nicht berechnet.
• Neu bei Apify? Mit dem kostenlosen Startguthaben kannst du den Actor direkt ausprobieren, ohne Vorkasse.
• Zum unverbindlichen Testen die voreingestellte E-Mail demo@example.com verwenden: Beispieldaten ohne Nutzungskosten.

FAQ

Was ist Kleinanzeigen? Kleinanzeigen (früher eBay Kleinanzeigen) ist Deutschlands größter Marktplatz für private und gewerbliche Kleinanzeigen, von Wohnungen über Möbel bis zu Fahrzeugen. Der Kontakt läuft über das interne Nachrichtensystem. Dieser Actor bedient genau dieses Postfach: senden, lesen und überwachen.

Brauche ich ein eigenes Kleinanzeigen-Konto? Für echte Nachrichten ja, der Actor arbeitet mit deinem eigenen Konto. Zum reinen Ausprobieren brauchst du keins: mit demo@example.com bekommst du Beispieldaten.

Brauche ich mein Passwort für jede Aktion? Nein. Das Passwort wird nur einmalig bei login gebraucht. Danach reicht für alle weiteren Aktionen deine E-Mail-Adresse.

Was passiert, wenn Kleinanzeigen eine Bestätigung verlangt? Der login-Lauf sagt dir das im Ergebnis und stoppt. Kleinanzeigen schickt dir dann entweder einen 6-stelligen SMS-Code oder eine E-Mail mit Bestätigungslink. Starte den Actor erneut mit verify2fa und trag den Code in verificationCode bzw. den Link in verificationUrl ein.

Was bedeutet „Dienst vorübergehend nicht verfügbar“ beim Anmelden? Kleinanzeigen konnte die Anmeldung vorübergehend nicht abschließen. Warte ein paar Minuten und starte login erneut. Die Anmeldegebühr von 2,99 USD fällt nur bei erfolgreicher Anmeldung an; die Startgebühr von 0,005 USD pro Lauf gilt trotzdem.

Wie lange ist der Code oder Link gültig? Das legt Kleinanzeigen fest. Löse ihn am besten zeitnah nach Erhalt ein.

Was kostet der Actor? Du zahlst nur pro Aktion: 2,99 USD je Konto-Anmeldung, 0,49 USD je gesendeter Nachricht, 0,01 USD je Abruf (Postfach, Konversation oder Überwachung), plus 0,005 USD Startgebühr je Lauf. Kein Abo, keine Grundgebühr. Mit dem kostenlosen Apify-Startguthaben kannst du direkt loslegen.

Warum wird pro Anmeldung berechnet und nicht pro Lauf? Die Anmeldung deines Kontos ist der aufwändige Teil. Danach bleibt deine Sitzung automatisch im Hintergrund aktiv, dafür zahlst du nichts extra. Das reine Senden, Lesen und Überwachen kostet nur die jeweilige Aktion. Erst wenn du dich später erneut anmeldest (etwa nach längerer Inaktivität), fällt wieder eine Anmeldegebühr an.

Wie viele Anzeigen kann ich in einem Lauf anschreiben? Bis zu 10 gleichzeitig über adUrls. Für mehr startest du einfach mehrere Läufe nacheinander.

Wie überwache ich neue Nachrichten am besten? Mit der Aktion monitor plus dem Apify Scheduler. Der erste Lauf legt die Baseline an, jeder weitere meldet nur Neues. Mit telegramUserId kommt die Info direkt aufs Handy.

Kann ich auch Anzeigen-Daten wie Preise und Fotos auslesen? Nicht mit diesem Actor, der kümmert sich um Nachrichten und Postfach. Für Inserate mit allen Details gibt es den Kleinanzeigen Immobilien Scraper.

Wie exportiere ich die Ergebnisse? Als JSON, CSV, Excel, XML oder HTML aus dem Tab Storage eines Laufs oder über die Apify API. JSON erhält verschachtelte Felder am saubersten.

Ist das erlaubt? Du interagierst mit kleinanzeigen.de ausschließlich über dein eigenes Konto und deine eigenen Konversationen. Du bist selbst dafür verantwortlich, die Nutzungsbedingungen von Kleinanzeigen und die geltenden Datenschutzregeln (DSGVO) einzuhalten. Nachrichteninhalte und Absendernamen sind personenbezogene Daten, geh entsprechend sorgsam damit um.

Support

• Fehler oder Problem? Öffne ein Issue im Issues-Tab.
• Vorschlag oder Wunsch? Ebenfalls im Issues-Tab.
• Kontakt: max@mapa.slmail.me

Rechtlicher Hinweis

Dieser Actor arbeitet über dein eigenes Kleinanzeigen-Konto. Du bist für die Einhaltung der Nutzungsbedingungen von Kleinanzeigen sowie der geltenden Datenschutzbestimmungen (DSGVO) selbst verantwortlich.

---

Kleinanzeigen-Nachrichten automatisiert: senden, Postfach lesen, Konversationen abrufen und neue Antworten überwachen, ganz über dein eigenes Konto.