mobile.de API: Fahrzeuge, Preise und Mehrwertsteuer als JSON
Die offizielle Schnittstelle von mobile.de richtet sich an Händler und zeigt den eigenen Bestand. Diese hier beantwortet die andere Frage: was steht am Markt, zu welchem Preis, und lässt sich die Mehrwertsteuer ausweisen. Genau der letzte Punkt ist für Export und Wiederverkauf entscheidend, und er ist hier ein Filter, kein Ratespiel.
Endpunkte
| endpoint | Was zurückkommt | Pflicht |
|---|---|---|
| search | Fahrzeugsuche mit den Filtern, die auch auf mobile.de greifen: Marke, Erstzulassung, Kilometerstand, Preis, Händler oder privat, MwSt-ausweisbar. Gesponserte Treffer bleiben erkennbar. | alle optional |
| listing | Das vollständige Inserat: Bruttopreis, Netto-Preis und MwSt-Satz sofern der Händler sie ausweisen kann, Erstzulassung, Vorbesitzer, HU, Ausstattung und alle Bilder. | listing_id |
| makes | Alle Marken einer Fahrzeugklasse, jeweils mit der Marken-id, die `search` erwartet. | alle optional |
| models | Alle Modelle einer Marke, einschließlich Baureihen-Gruppen (`is_group` true, etwa '3er Reihe (Alle)'). | make |
Jeder Aufruf wird in Credits abgerechnet. Fehlgeschlagene und blockierte Aufrufe sind kostenlos.
Funktionierendes Beispiel
Wer exportiert, filtert direkt auf vat_deductible und bekommt nur Fahrzeuge, bei denen die Mehrwertsteuer ausgewiesen werden kann. Der Netto-Preis steht dann als Zahl im Datensatz und muss nicht aus dem Bruttopreis zurückgerechnet werden.
curl -X POST https://api.reefapi.com/mobile-de/v1/search \
-H "x-api-key: IHR_SCHLUESSEL" \
-H "content-type: application/json" \
-d '{"make": "bmw", "year_min": 2020, "mileage_max": 150000, "seller_type": "dealer", "vat_deductible": true}'{
"ok": true,
"data": {
"total_results": 50536,
"results": [
{
"listing_id": "440052586",
"first_registration": "12/2023",
"mileage_km": 25000,
"price": 92800.0,
"price_net": 77983.19,
"vat_rate": 19.0,
"vat_deductible": true
}
]
},
"meta": { "record_count": 100, "cache_hit": false, "mode": "live" }
}Statt eines eigenen mobile.de-Scrapers
Einen Scraper für mobile.de zu schreiben ist der naheliegende erste Schritt. Was später auffällt: ändert sich der Aufbau der Trefferliste, liefert der Parser eine leere Liste statt eines Fehlers, und bei größeren Läufen greift der Bot-Schutz mitten im Durchlauf.
Der Punkt, an dem ein eigener Scraper am häufigsten still falsch liegt, ist die Mehrwertsteuer: steht im Inserat nur ein Bruttopreis, lässt sich daraus nicht ableiten, ob die MwSt ausweisbar ist. Hier ist das ein eigenes Feld und ein Filter.
Für eine einmalige Auswertung bleibt das eigene Skript günstiger, das sagen wir offen. Für eine Bestandsüberwachung, die täglich läuft, zahlt man nicht für den Code, sondern für die unbemerkten Ausfälle.
Grenzen und ehrliche Hinweise
- Das ist nicht die offizielle mobile.de-Schnittstelle, und wir haben keine Partnerschaft mit mobile.de.
- Pro Suche sind 100 Treffer je Seite und 50 Seiten erreichbar, also rund 5.000 Inserate. Seite 51 antwortet mit INVALID_PARAM statt still die letzte Seite zu wiederholen.
- Netto-Preis und MwSt-Satz kommen nur, wenn der Händler sie ausweist. Sonst sind die Felder null und wir rechnen nichts zurück.
- Kein Cache: jeder Aufruf zeigt den Stand zum Zeitpunkt der Anfrage.