Kleinanzeigen Nachrichten API - Senden & Empfangen
Pricing
from $0.29 / nachrichtenversand
Kleinanzeigen Nachrichten API - Senden & Empfangen
Sende Nachrichten an Kleinanzeigen-Inserate, lies dein Postfach und überwache neue Antworten automatisch. Batch-Versand an bis zu 10 Anzeigen pro Lauf, vollständige Konversationen, Telegram-Benachrichtigungen. Nutzt dein eigenes Konto.
Pricing
from $0.29 / nachrichtenversand
Rating
0.0
(0)
Developer
ClearPath
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Share
Kleinanzeigen Nachrichten & Postfach | Senden, Empfangen & Überwachen
Dein Kleinanzeigen-Postfach auf Autopilot: senden, lesen, überwachen, über dein eigenes Konto.
| Clearpath Immobilien Suite • Kleinanzeigen & ImmoScout24: Inserate, Nachrichten, Bewerbungen | |||
|
Kleinanzeigen Nachrichten API ➤ Du bist hier |
Inserate mit allen Details |
Automatische Bewerbungen |
Inserate mit 50+ Feldern |
Schreib Anbieter an, behalte dein Postfach im Blick und verpass keine Antwort mehr, ganz ohne ständiges Nachsehen in der App. Konto einmal anmelden, den Rest übernimmt der Actor.
🆓 Ohne eigenes Konto testen: E-Mail
demo@example.comstehen lassen, Postfach abrufen starten, und du bekommst sofort echte Beispieldaten. Kostenlos und unverbindlich.
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
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.comalles 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:
- 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.
- Zweiter Lauf, Aktion
verify2fa(nur falls nötig): denselbenkaEmailverwenden und je nachdem, was du bekommen hast, den SMS-Code im FeldverificationCodeoder den Link im FeldverificationUrleintragen.
Danach ist dein Konto dauerhaft angemeldet. 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.
Neue Nachrichten überwachen
Mit der Aktion monitor musst du nicht mehr selbst nachschauen, ob jemand geantwortet hat:
- Baseline: Der erste Lauf merkt sich deinen aktuellen Stand, ganz ohne Meldung.
- Nur Neues: Jeder folgende Lauf gibt ausschließlich Nachrichten zurück, die seit dem letzten Lauf neu eingegangen sind.
- Push aufs Handy: Mit
telegramUserIdbekommst 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
- Schreib @userinfobot auf Telegram eine kurze Nachricht. Er antwortet mit deiner numerischen User-ID.
- Trag diese ID im Feld
telegramUserIdein. - Ö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,conversationodermonitor, 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.comverwenden: 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.
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.
