mobileLogo

DE EN

Schnittstellenübersicht

Name Benutzerkonto-Typ Datenformat Beschreibung
Upload-Schnittstelle Für API-Benutzerkonto und Händler-Benutzerkonto Seller-XML (für Upload-Schnittstelle) und CSV Schnittstelle zum Hochladen kompletter Fahrzeugbestände per Upload API oder über ein Formular im Händlerbereich. Asynchrone Verarbeitung.
Zum Hochladen von Inseraten eignet sich auch die Seller-API.
Seller-API
(nur auf Englisch verfügbar)
Für API-Benutzerkonto Unified Data Format
(nur auf Englisch verfügbar)
REST-Schnittstelle zum Bearbeiten des Fahrzeugbestandes und für andere Funktionen.
Search-API / Inserats-Einbindung
(nur auf Englisch verfügbar)
Für API-Benutzerkonto und Händler-Benutzerkonto (für eigenen Datenbestand) Search-XML REST-Schnittstelle zum Suchen und Herunterladen von Inseraten.
Ad-Stream Für API-Benutzerkonto Search-XML Websocket basierte Schnittstelle zum empfangen von serverseitigen Ereignissen (angelegte oder veränderte Inserate)

API Overview

Name Account-type Data-format Description
Upload-Interface For API-Account and Dealer-Account Seller-XML (for Upload-Interface) and CSV Interface to upload full vehicle inventories via upload API or a form in Dealer-Area. Asynchronous processing.
Also consider using the Seller-API to upload ads.
Seller-API For API-Account Unified Data Format REST-API to edit the vehicle inventory and for other functionality.
Search-API / Ad-Integration For API-Account and Dealer-Account (for own inventory) Search-XML REST-API to search and download ads.
Ad-Stream
(only available in German)
For API-Account Search-XML Websocket based API to receive server side events (created or changed ads).

Änderungshistorie

Neuste Schnittstellenänderungen.

Changelog

Latest API changes.
Neuste Marken- und Modellaktualisierungen. Latest Make Model Updates.

XML

Beachten Sie auch unsere allgemeinen XML Hinweise (nur auf englisch).

XML

Also see our general XML notes.

Begriffserklärung

Some definitions

Benutzerkonto

Um auf unsere Schnittstellen zugreifen zu können, brauchen Sie ein Benutzerkonto. Es gibt zwei Arten von Benutzerkonto:

  • API-Benutzerkonto - ein allgemeines Schnittstellen-Benutzerkonto, auf dem bestimme APIs (z.B. Upload-Schnittstelle, Search-API) freigeschaltet werden können. Bitte wenden Sie sich für Freischaltung und Zugangsdaten an den Kundenservice.
  • Händler-Benutzerkonto - ist mit einem dealer-seller verbunden. Sie können die Zugangsdaten für bestimmte APIs im Händlerbereich erhalten.

Account

For accessing our API, you need an account. There are two account types:

  • API-Account - a common API account, for which certain APIs (e.g. Upload-Interface, Search-API) can be activated. Please contact customer support for activation and credentials.
  • Dealer-Account - is connected to a dealer-seller. You can get credentials for certain APIs from within Dealer-Area.

Händlerbereich

Der Händlerbereich ist der Teil unserer Plattform, auf der sich ein dealer-seller einloggen und z.B. seinen Fahrzeugbestand bearbeiten kann.

Dealer-Area

Dealer-Area is the part of our platform, where a dealer-seller can login and do things like editing the vehicle inventory.

Referenzdaten

Hier finden Sie Referenztabellen (nur auf Englisch) für aufzählbare Datentypen wie Ausstattungsmerkmale, Farben, Marken, Modelle und andere.

Textformatierung & Smart Attribute

Hier finden Sie Information zur Formatierung der Fahrzeugbeschreibung (nur auf Englisch). Information zu unseren zusätzlichen Ausstattungsmerkmalen in der Fahrzeugbeschreibung finden Sie hier.

Reference data

Here you find reference tables for the enumerated data types like features, colors, makes, models and others.

Textformatting & Smart Attributes

Here you find information regarding how to format the vehicle description. Information how to use our Smart Attributes (in German only) can be found here.

seller

Ein seller ist ein Fahrzeugverkäufer, der Fahrzeuge auf dem mobile.de Marktplatz anbietet. Es gibt drei verschiedene seller Arten:

  • dealer - ein kommerzieller Fahrzeughändler
  • FSBO - (For Sale By Owner) ein Privatverkäufer
  • commercial FSBO - ein kommerzieller Verkäufer, aber kein Händler. Wird verwendet für Firmen, die von ihnen benutzte Fahrzeuge verkaufen, z.B. ein Lieferdienst, der nicht mehr benötigte Lieferfahrzeuge verkauft.

In der Seller-API und der Search-API werden seller durch einen seller-key identifiziert (auch seller-ID oder customer-ID genannt).
Achtung: Der seller-key ist nicht die Kundennummer, die ein dealer bei uns hat.

seller

A seller is the entity which offers vehicles at the mobile.de marketplace. There are three different seller types:

  • dealer - this is a commercial car/vehicle dealer
  • FSBO - (For Sale By Owner) non-commercial car/vehicle seller
  • commercial FSBO - a commercial company/seller that sells vehicles used by that company itself. For example, a delivery service sells some of their delivery vehicles.

In Seller-API and Search-API, sellers are identified by the seller-key (also called seller-ID or customer-ID).
Note: The seller-key is not the customer-number that our dealer customers have.

site / site-id / site-key

mobile.de GmbH betreibt verschiedene Plattformen (sites) in verschiedenen Ländern, z.B. www.mobile.de in Deutschland und www.automobile.it in Italien.
Jede dieser sites wird durch einen site-key identifiziert. Sie finden die volle Liste der site-keys in unseren Referenzdaten.

Die Schnittstellen stehen für alle sites zur Verfügung, wobei jede site verschiedene Regeln zum Anbieten von Fahrzeugen und verschiedene Referenzdaten haben kann.
Beim Einstellen von Fahrzeuginseraten sollten Sie also beachten, auf welcher site der seller registriert ist.
Weitere Informationen finden Sie in der Seller-API Beschreibung.

site / site-id / site-key

mobile.de GmbH operates different platforms (sites) in different countries, for example www.mobile.de in Germany and www.automobile.it in Italy.
Each of these sites is identified by a site-key (you can find a full list of the site-keys in our reference data).

The API is available for all sites, albeit each site may have different rules for offering a vehicle and different sets of reference data.
Hence when offering (posting) a vehicle, you should consider the site your seller is registered and operational at.
You will find more information on that matter in the seller API section.

Kundenservice Kontakt

Bitte wenden Sie sich für weitere Informationen an unseren Kundenservice.

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

Customer support contact

Please contact Customer Support if you require more information.

Germany Phone: +49 (0) 30 81097500
Contact form
Italy Phone: +39 02 30410311
Contact form
France Phone: +33 (0) 810 000 220
Contact form

Nutzungsbedingungen

Die Schnittstellen werden von der mobile.de GmbH betrieben.

Impressum

Hier finden Sie die Allgemeinen Geschäftsbedingungen und Nutzungsbedingungen für verschiedene Nutzungen der API-Schnittstelle und für die Inseratseinbindung.

Terms and conditions

The API is operated by mobile.de GmbH.

Imprint

Please note the terms and conditions regarding the API-Usage and Ad-Integration.