🚗 mobile.de API

Portal: services.mobile.de
Auth: Basic Auth / API Account
Status: 🟢 Ready

---

Übersicht

mobile.de ist der größte Fahrzeugmarkt Deutschlands. Die API ermöglicht: - Fahrzeug-Inventar verwalten - Inserate suchen und abrufen - Verkäufer-Daten verwalten - Insights und Statistiken

---

Account-Typen

Typ	Beschreibung	Aktivierung
API-Account	Allgemeiner Zugang	Kundenservice
Dealer-Account	Händler-spezifisch	Dealer-Area

---

APIs

Seller API (Inventar)

Methode	Endpunkt	Beschreibung	Cache TTL
GET	/api/mobilede/vehicles	Alle Fahrzeuge	15 min
GET	/api/mobilede/vehicles/:id	Einzelnes Fahrzeug	15 min
POST	/api/mobilede/vehicles	Fahrzeug erstellen	-
PUT	/api/mobilede/vehicles/:id	Fahrzeug aktualisieren	-
DELETE	/api/mobilede/vehicles/:id	Fahrzeug löschen	-

Vehicle Images

Methode	Endpunkt	Beschreibung	Cache TTL
GET	/api/mobilede/vehicles/:id/images	Alle Bilder	30 min
POST	/api/mobilede/vehicles/:id/images	Bild hochladen	-
DELETE	/api/mobilede/vehicles/:id/images/:iid	Bild löschen	-
PUT	/api/mobilede/vehicles/:id/images/order	Reihenfolge ändern	-

Search API

Methode	Endpunkt	Beschreibung	Cache TTL
GET	/api/mobilede/search	Fahrzeuge suchen	10 min
GET	/api/mobilede/search/makes	Marken abrufen	24h
GET	/api/mobilede/search/models/:makeId	Modelle abrufen	24h

Ad-Stream (WebSocket)

Event	Beschreibung
ad.created	Neues Inserat
ad.updated	Inserat geändert
ad.deleted	Inserat gelöscht

Insights API

Methode	Endpunkt	Beschreibung	Cache TTL
GET	/api/mobilede/insights/views	Aufrufe	1h
GET	/api/mobilede/insights/leads	Anfragen	1h
GET	/api/mobilede/insights/comparison	Marktvergleich	1h

Reference Data

Methode	Endpunkt	Beschreibung	Cache TTL
GET	/api/mobilede/refdata/makes	Alle Marken	24h
GET	/api/mobilede/refdata/models	Alle Modelle	24h
GET	/api/mobilede/refdata/features	Ausstattungen	24h
GET	/api/mobilede/refdata/colors	Farben	24h
GET	/api/mobilede/refdata/sites	Plattformen (DE, IT, FR)	24h

---

Request-Beispiel

// POST /api/mobilede/vehicles
const response = await fetch('/api/mobilede/vehicles', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${btoa(username + ':' + password)}`
  },
  body: JSON.stringify({
    category: 'Car',
    make: 'BMW',
    model: '320i',
    modelDescription: 'M Sport Package',
    firstRegistration: '2023-06',
    mileage: 15000,
    fuel: 'PETROL',
    power: 184,
    transmission: 'AUTOMATIC',
    color: 'BLACK_METALLIC',
    price: {
      value: 42500,
      currency: 'EUR',
      negotiable: true
    },
    features: ['NAVIGATION', 'LEATHER', 'SUNROOF', 'PARKING_SENSORS'],
    description: 'Gepflegter BMW 320i mit M Sport Paket...',
    images: [
      { url: 'https://example.com/car1.jpg', order: 1 }
    ]
  })
});

// Response
{
  "id": "123456789",
  "adId": "MD-123456789",
  "status": "ACTIVE",
  "url": "https://www.mobile.de/fahrzeug/123456789",
  "createdAt": "2024-12-30T12:00:00Z"
}

---

TypeScript Types

interface MobileDeVehicle {
  id: string;
  adId: string;
  category: 'Car' | 'Motorcycle' | 'Truck' | 'Caravan';
  make: string;
  model: string;
  modelDescription?: string;
  firstRegistration: string; // YYYY-MM
  mileage: number;
  fuel: 'PETROL' | 'DIESEL' | 'ELECTRIC' | 'HYBRID' | 'LPG' | 'CNG';
  power: number; // kW
  transmission: 'MANUAL' | 'AUTOMATIC' | 'SEMI_AUTOMATIC';
  color: string;
  price: MobileDePrice;
  features: string[];
  description: string;
  images: MobileDeImage[];
  status: 'DRAFT' | 'ACTIVE' | 'INACTIVE' | 'SOLD';
  url: string;
  createdAt: string;
  updatedAt: string;
}

interface MobileDePrice {
  value: number;
  currency: 'EUR';
  type?: 'FIXED' | 'NEGOTIABLE' | 'ON_REQUEST';
  vatDeductible?: boolean;
}

interface MobileDeImage {
  id?: string;
  url: string;
  order: number;
}

interface MobileDeSearchResult {
  totalCount: number;
  vehicles: MobileDeVehicle[];
  facets: {
    makes: { name: string; count: number }[];
    priceRanges: { min: number; max: number; count: number }[];
    fuels: { type: string; count: number }[];
  };
}

---

Plattformen (Sites)

Site Key	Land	URL
mobile.de	Deutschland	mobile.de
automobile.it	Italien	automobile.it
automobile.fr	Frankreich	automobile.fr

---

Rate Limits

API	Limit	Window
Seller API	100/min	Per Account
Search API	60/min	Per IP
Insights	30/min	Per Account

---

Kontakt

Land	Telefon
Deutschland	+49 (0) 30 81097500
Italien	+39 02 30410311
Frankreich	+33 (0) 810 000 220

---

Dokumentation: services.mobile.de/manual