Bisher drehte sich bei Kleinanzeigen Agent alles um öffentliche Inserate: suchen, beobachten, vergleichen. Sobald es um ein konkretes Inserat ging, musstest du aber wieder in die App oder auf die Webseite wechseln, um Anfragen zu lesen und zu beantworten.
Ab heute geht auch das per API. Mit der Konto-API verbindest du dein eigenes Kleinanzeigen-Konto mit Kleinanzeigen Agent. Danach liest dein Programm deine Chats und antwortet in deinem Namen, mit demselben API-Schlüssel, den du schon für die Suche nutzt. Die Konto-API startet als Beta und steht ab sofort allen Konten offen.
Was du heute schon machen kannst
- Chats abrufen: alle Chats deines Kontos mit Inserat, Gegenüber, ungelesenen Nachrichten und einer kurzen Vorschau.
- Chats lesen: einen Chat öffnen und den kompletten Nachrichtenverlauf laden.
- Antworten: auf Nachrichten antworten, gefahrlos wiederholbar über eine eigene Auftrags-ID.
- Neue Chats starten: den Anbieter eines Inserats anschreiben und die erste Nachricht direkt mitschicken.
Weitere Kontofunktionen sind bereits geplant.
Damit holst du neue Anfragen zum Beispiel in dein eigenes Tool, beantwortest sie aus deinem System heraus oder schreibst Anbieter passender Inserate direkt aus deiner Suche an.
Deine eigene IP-Adresse
Mit dem Konto-API-Zugang bekommst du eine feste IP-Adresse in Deutschland, die nur für dein Konto genutzt wird. Jede API-Anfrage, die wir in Verbindung mit deinem Konto senden, stammt von dieser gebuchten IP-Adresse. Das gilt für die Verknüpfung nach deiner Anmeldung genauso wie für das Lesen von Chats, das Senden von Nachrichten und das Erneuern deiner Sitzung.
Kleinanzeigen sieht unsere Anfragen für dein Konto damit immer von derselben Adresse. Diese IP verwendet kein anderer Nutzer. Einrichtung und Verlängerung übernehmen wir automatisch.
Dein Passwort sehen wir nie
Du meldest dich direkt auf kleinanzeigen.de an, so wie sonst auch. Wir bekommen danach nur ein Sitzungstoken, mit dem wir auf dein Konto zugreifen, und speichern es verschlüsselt.
Genau dafür gibt es eine kleine Chrome-Erweiterung. Sie reicht deine Anmeldung einmalig an uns weiter und liest keine Passwörter, Cookies oder Chats. Nach der Anmeldung kannst du sie wieder entfernen. Verlangt Kleinanzeigen später eine neue Anmeldung, brauchst du sie wieder. Lässt du sie installiert, reicht dafür ein Klick.
In drei Schritten startklar
Alles passiert auf einer Seite in deinem Dashboard unter Konto-API:
- Zugang buchen. Für 9,90 € netto im Monat richten wir dir deine eigene IP-Adresse ein. Das dauert meist nur ein paar Minuten.
- Erweiterung installieren. Die Seite zeigt dir den Download und jeden Klick in Chrome.
- Bei Kleinanzeigen anmelden. Ein neuer Tab öffnet die offizielle Anmeldung. Danach steht auf der Seite „Alles bereit“.
Ab dann reicht dein API-Schlüssel.
So sieht ein Abruf aus
Die Konto-API nutzt deinen gewohnten Schlüssel im Header klaz_key. Die Chatliste holst du so:
curl "https://api.kleinanzeigen-agent.de/api/v2/kleinanzeigen/account/conversations" \
-H "klaz_key: klaz_live_..."
Jeder Chat kommt in einem festen Format zurück:
{
"conversation_id": "a1b2c3:d4e5f6",
"ad_id": "1234567890",
"ad_title": "Sofa",
"counterparty": "Max",
"unread": true,
"preview": "Ist das Sofa noch da?"
}
Für eine Antwort reicht die Nachricht selbst. Eine request_id kannst du mitgeben, sonst erzeugen wir eine und schicken sie in der Antwort zurück. Sendest du denselben Auftrag mit derselben request_id noch einmal, verschicken wir die Nachricht kein zweites Mal und berechnen auch keine weiteren Credits. Alle Endpunkte, Felder und Fehlercodes stehen in der Dokumentation.
Lass deine KI dein Kleinanzeigen managen
Die Kontofunktionen gibt es auch außerhalb der REST-API. Verbinde Claude, Codex oder einen anderen KI-Client mit unserem MCP Server, und dein Assistent kümmert sich auf Wunsch um dein Kleinanzeigen-Postfach. Beim Verbinden setzt du einfach das Häkchen für den Zugriff auf deine Chats.
Danach reicht ein Satz in deinem KI-Client:
Schau in meine Kleinanzeigen-Chats. Wer fragt nach dem Sofa? Antworte allen, dass es noch da ist und ab 18 Uhr abgeholt werden kann.
Fasse mir alle ungelesenen Nachrichten von heute zusammen und schlag mir Antworten vor.
Such mir ein gebrauchtes Rennrad in Berlin bis 400 € und schreib die drei besten Anbieter an, ob das Rad noch verfügbar ist.
Der Assistent liest deine Chats, sucht passende Inserate und formuliert die Nachrichten. Bevor etwas verschickt wird, zeigt er dir den Text, und gesendet wird nur auf deine Anweisung. Über A2A funktioniert das genauso für eigene Agentensysteme, die Chats lesen und Nachrichten als strukturierte Aufträge senden.
Im Kleinanzeigen Chat entwirft der Assistent Nachrichten für dich. Jeden Versand bestätigst du selbst, bevor etwas bei deinem Gegenüber ankommt.
Was es kostet
Der Konto-API-Zugang kostet 9,90 € netto im Monat zzgl. USt. und ist monatlich kündbar. Er deckt deine eigene IP-Adresse ab. Die einzelnen Aktionen rechnest du wie gewohnt in Credits aus deinem bestehenden Guthaben ab:
| Aktion | Credits |
|---|---|
| Chatliste abrufen | 5 |
| Chat öffnen | 10 |
| Nachricht senden | 25 |
| Neuen Chat starten | 50 |
Schlägt das Lesen eines Chats oder der Chatliste fehl, buchen wir die Credits automatisch zurück. Der Verbindungsstatus ist kostenlos.
Gut zu wissen: die Beta
Die Konto-API nutzt keine offizielle Schnittstelle von Kleinanzeigen. Wir tun viel dafür, dass alles zuverlässig läuft, und die eigene IP-Adresse pro Konto ist ein wichtiger Teil davon. Wie Kleinanzeigen auf die Nutzung reagiert, können wir trotzdem nicht vorhersagen. Kleinanzeigen kann Funktionen jederzeit ändern und Konten prüfen, einschränken oder sperren.
Deshalb empfehlen wir dir für die Konto-API ein neu angelegtes Kleinanzeigen-Konto ohne Verkaufs- und Bewertungshistorie. Dein persönliches Hauptkonto solltest du dafür nicht verwenden.
Wir überwachen die Nutzung anhand von Anfrage-Metadaten wie Anzahl und Häufigkeit, um Spam und Massennachrichten zu verhindern. Kleinanzeigen Agent ist ein unabhängiger Dienst und steht in keiner Verbindung zu kleinanzeigen.de. Die Einzelheiten findest du in unseren AGB unter §9a.
Jetzt starten
Richte die Konto-API unter /app/konto-api ein. Einen Überblick über alle Funktionen findest du auf der Konto-API-Seite, die technischen Details in der Dokumentation.
Wenn du Fragen oder Feedback hast, schreib uns an office@kleinanzeigen-agent.de. Gerade in der Beta hilft uns jede Rückmeldung.