mobile.de API: Was die Schnittstelle kann und wie du sie an WordPress anbindest
Über die mobile.de API holt sich eine Website den Fahrzeugbestand direkt aus dem Händlerkonto. Hier steht, was die Schnittstelle liefert, wie du Zugang bekommst, was das kostet und wie die Anbindung an WordPress mit BasisCars aussieht.
Was die mobile.de API ist
Die mobile.de API ist die Schnittstelle des Händlerbereichs von mobile.de; Anbieter ist die mobile.de GmbH. Über sie rufen Programme wie BasisCars die Fahrzeugdaten eines Händlerkontos ab: Preise, technische Daten, Ausstattungslisten, Beschreibungstexte und Bilder.
BasisCars liest den Bestand aus mobile.de aus. Inserate anlegen, ändern oder auf anderen Börsen veröffentlichen kann das Plugin nicht; das bleibt bei mobile.de.
Die technische Dokumentation veröffentlicht mobile.de unter services.mobile.de. Wer BasisCars nutzt, muss sie nicht lesen: Das Plugin übernimmt die Abfrage.
mobile.de ist eine eingetragene Marke der mobile.de GmbH. BasisCars ist ein eigenständiges Produkt und steht in keiner geschäftlichen Verbindung zur mobile.de GmbH.
Zugang zur mobile.de API: Kundennummer und API-Passwort
Voraussetzung ist ein Händlerkonto bei mobile.de. Zum Zugang gehören zwei Angaben: Kundennummer und API-Passwort.
Das API-Passwort erzeugst du im Händlerbereich von mobile.de unter Schnittstellen; es ist nicht dein normales Kundenpasswort. Beide Angaben trägst du in BasisCars ein, die Händler-ID erkennt das Plugin automatisch.
Meldet die Schnittstelle einen Fehler 401, erzeuge das API-Passwort neu und prüfe, dass nicht das Kundenpasswort eingetragen ist. Mehr dazu in der Fehlerbehebung der Dokumentation.
Mehrere Kundennummern, etwa für mehrere Standorte, lassen sich je nach Tarif zusammen anbinden: im Tarif Profi bis zu zehn, im Tarif Enterprise unbegrenzt.
Was die mobile.de API kostet
Ob mobile.de für den Schnittstellenzugang etwas berechnet, hängt von deinem Händlervertrag ab; BasisCars hat darauf keinen Einfluss. Im Zweifel fragst du deinen Ansprechpartner bei mobile.de.
BasisCars kostet je nach Bestandsgröße 10, 30, 50 oder 100 Euro im Monat zuzüglich Umsatzsteuer; bei jährlicher Zahlung zehn Monate, also 100, 300, 500 oder 1.000 Euro im Jahr. Die Tarife unterscheiden sich in der Zahl der Fahrzeuge (bis 50, 100, 250, unbegrenzt), Kundennummern und Domains. Gekündigt wird zum Ende der laufenden Abrechnungsperiode.
Welche Daten über die Schnittstelle kommen
Für jedes Fahrzeug überträgt BasisCars rund vierzig Felder aus mobile.de: Marke, Modell und Ausführung, Preis, Leistung, Kraftstoff, Getriebe, Kilometerstand, Erstzulassung, HU, Vorbesitzer, Farben, Verbrauch, CO₂-Wert und Schadstoffklasse, dazu Ausstattungsliste, Beschreibungstext und alle Bilder.
Die Verbrauchs- und Emissionswerte zeigt das Plugin auf der Fahrzeugseite nach EnVKV und WLTP an, auch für Elektro- und Hybridfahrzeuge. Die Werte selbst stammen aus deinem mobile.de Inserat; für ihre Richtigkeit bist du als Händler verantwortlich. Welche Angaben die Verordnung verlangt, steht im Ratgeber zur Pkw-EnVKV.
Alle Felder liegen als Custom Fields in WordPress und lassen sich in Templates, Elementor oder Meta-Descriptions weiterverwenden; die vollständige Liste steht in der Feldübersicht der Dokumentation.
Automatische Aktualisierung
BasisCars gleicht den Bestand in einem einstellbaren Intervall ab, etwa stündlich oder täglich, über den WordPress-Cron oder, bei großen Beständen zuverlässiger, einen Cronjob deines Servers. Was sofort sichtbar sein soll, stößt du mit einer manuellen Synchronisation an.
Verkaufte oder bei mobile.de gelöschte Fahrzeuge verschwinden beim nächsten Abgleich von der Website. Damit ein Ausfall der Schnittstelle nicht zu einer leeren Fahrzeugliste führt, löscht das Plugin standardmäßig höchstens 30 Prozent des Bestands auf einmal.
Details: Automatischer Abgleich und Sicherheitslimit in der Dokumentation.
mobile.de API in WordPress einbinden
Mit BasisCars brauchst du dafür keine Programmierung. Die Anbindung besteht aus drei Schritten:
1. Plugin hochladen
Das ZIP-Archiv unter Plugins → Installieren → Plugin hochladen einspielen und aktivieren.
2. Lizenz aktivieren
Lizenzschlüssel und Registrierungs-E-Mail unter BasisCars → Einstellungen → Konto eintragen.
3. Zugangsdaten eintragen
Kundennummer und API-Passwort unter Bestand → mobile.de → API Anbindung hinterlegen und den ersten Abgleich starten.
Die Fahrzeugliste liegt auf einer normalen WordPress-Seite: per Shortcode, als Block in Gutenberg, als Widget in Elementor oder als Modul in Divi. Jedes Fahrzeug bekommt eine eigene Unterseite mit eigener Adresse.
Bei den Bildern hast du die Wahl: direkt von mobile.de geladen (spart Speicherplatz, übermittelt aber die IP-Adressen deiner Besucher an mobile.de) oder in deine Mediathek kopiert, dann liegt alles auf deinem Server.
Voraussetzungen sind WordPress ab Version 5.8 und PHP ab Version 7.4. Die Schritte im Einzelnen zeigt die Installationsanleitung.
Ohne API: CSV-Import, und warum ein iFrame keine Lösung ist
Wer die Schnittstelle nicht nutzen kann oder Fahrzeuge aus anderen Quellen hat, lädt den Bestand als CSV-Tabelle hoch. Der CSV-Import ist in allen Tarifen enthalten und läuft derzeit als Beta.
Ein iFrame von mobile.de ist dagegen keine Alternative: Die Fahrzeuge werden nur eingeblendet und stehen nicht auf deiner Website. Google indexiert sie nicht unter deiner Domain, und die IP-Adressen deiner Besucher gehen bei jedem Aufruf an mobile.de.
Häufige Fragen zur mobile.de API
Brauche ich Programmierkenntnisse?
Nein. Du lädst das Plugin hoch, aktivierst die Lizenz und trägst Kundennummer und API-Passwort ein. Die Fahrzeugliste setzt du wie jeden anderen Inhalt per Shortcode, Block oder Elementor-Widget auf eine Seite.
Kann ich mehrere Kundennummern oder Standorte anbinden?
Ja, je nach Tarif: Beginner und Händler sind auf eine Kundennummer ausgelegt, Profi erlaubt bis zu zehn, Enterprise unbegrenzt viele. Die Nummern trägst du kommagetrennt ein, die Bestände laufen in einer gemeinsamen Fahrzeugliste zusammen.
Werden die Bilder von mobile.de geladen oder bei mir gespeichert?
Beides ist möglich. Im Auslieferungszustand werden die Bilder direkt von mobile.de geladen; dabei wird die IP-Adresse deiner Besucher an mobile.de übertragen, was in die Datenschutzerklärung gehört. Stellst du unter Bestand → mobile.de → Medien und Bilder auf Mediathek-Download um, liegen alle Bilder auf deinem eigenen Server.
Wo bekomme ich Hilfe, wenn die Anbindung nicht klappt?
Die häufigsten Ursachen stehen in der Fehlerbehebung der Dokumentation: Fehler 401 bei falschem Passwort, ein Auto-Sync, der ohne Server-Cron nicht regelmäßig läuft, ein abbrechender Bilder-Import bei knappem PHP-Speicher. Hilft das nicht, schreib an info@basiscars.com.
Gibt es eine Testumgebung (Sandbox) für die mobile.de API?
Für BasisCars brauchst du keine. Das Plugin arbeitet mit deinem Händlerkonto und liest den Bestand nur aus; anlegen oder ändern kann es nichts. Ob mobile.de dir für eigene Entwicklungen eine Testumgebung bereitstellt, klärst du über den Schnittstellenbereich deines Händlerkontos.
Wie oft wird die Schnittstelle abgefragt?
So oft, wie du es einstellst, zum Beispiel stündlich oder täglich, dazu jederzeit auf Knopfdruck. Für den Bestand eines Händlers reicht das aus. Welche Abfragegrenzen mobile.de setzt, steht in dessen Schnittstellen-Dokumentation.
Wo finde ich die technische Dokumentation der mobile.de API?
mobile.de veröffentlicht sie unter services.mobile.de, auf Englisch. Für die Einrichtung von BasisCars brauchst du sie nicht: die Schritte stehen auf Deutsch in der Dokumentation.