Table of Contents

The Search-API is also known as Ad-Integration (german: Inserats-Einbindung).

Introduction

We offer a search API for…​

It’s important to note that accessing ad data through a search result offers a more limited scope compared to a direct ad download facilitated by an ad-key. Consequently, certain ad properties accessible via direct ad download (using ad-key) may not be available in a search result containing the same ad.

Rest

Our API design adheres to the REST principle (Representational State Transfer), ensuring efficiency and clarity in data transmission. For further insights into this software architecture, refer to this link.

Language support

Many ad properties come with translated descriptions. While the default language is English, enriching the HTTP header field Accept-Language with the relevant value allows the client to obtain a translated description in all supported languages on mobile.de.

  • Please note that this feature is solely supported for Legacy XML/JSON (with content type application/xml or application/json).

Authentication

To access our API, authentication via HTTP basic authentication with a username and password is mandatory. For a comprehensive understanding of HTTP basic authentication, consult this resource or RFC 1945 Section 10.2.

Media Types

The API supports data retrieval in Legacy XML, New Json and New XML format. Detailed description of data structures for individual data format is available in the Data Formats section.

To specify the preferred data format, the API client must use the appropriate Accept header in the HTTP request:

Media type Http header

Legacy Xml

Accept: application/xml

New Json

Accept: application/vnd.de.mobile.api+json

New Xml

Accept: application/vnd.de.mobile.api+xml

HTTP header fields

HTTP header field Possible values Description

Accept

  1. application/xml

  2. application/vnd.de.mobile.api+xml

  3. application/vnd.de.mobile.api+json

  1. Selects Legacy XML as output format.

  2. Selects New XML as output format

  3. Selects New Json as output format

Accept-Encoding

gzip

Sending this field allows you to receive a zipped result file.

Accept-Language

cz, de, en, es, fr, it, pl, ro or ru

Sending this field allows you to control the result language. (Only for Legacy XML)

Fetch single ads by an ad-key

Fetch details of an ad

Request

Resource Path Method Content-Type / Accept header

https://services.mobile.de/search-api/ad/{ad-key}

GET

  1. application/xml

  2. application/vnd.de.mobile.api+xml

  3. application/vnd.de.mobile.api+json

Example request-line and headers

GET /search-api/ad/456 HTTP/1.0
Host: services.mobile.de
Accept: application/xml

Response

Response Status Explanation

200 (OK)

Success

404

You Provided a wrong ad-key

Finding Ads

Search for ads by various criteria

Request

Resource Path Method Content-Type / Accept header

https://services.mobile.de/search-api/search?{search-parameters}

GET

  1. application/xml

  2. application/vnd.de.mobile.api+xml

  3. application/vnd.de.mobile.api+json

Example request-line and headers

GET /search-api/search?exteriorColor=BLACK&modificationTime.min=2012-05-04T18:13:51.0Z HTTP/1.0
Host: services.mobile.de
Accept: application/xml

Response

Response Status Explanation

200 (OK)

Success

400

This code is returned when there is an issue with the query you submitted. In these cases, the API attempts to include as many details as possible in the error response to help you identify and resolve the problem.

Number of search results and paginating

Due to technical constraints, the maximum number of ads that can be retrieved through paginated result pages is limited to 2000. This means if your search query matches more than 2000 ads, and you have set page.size to 20, only the first 100 pages will contain ads (or 20 pages if page.size is set to 100). Subsequent pages will be empty.

This limitation is indicated at the top of the search result:

Legacy xml
<search:total>1813062</search:total>
<search:page-size>100</search:page-size>
<search:current-page>1</search:current-page>
<search:max-pages>20</search:max-pages>
New XML
<searchResult>
    <total>1813062</total>
    <pageSize>100</pageSize>
    <currentPage>1</currentPage>
    <maxPages>20</maxPages>
    <ads>
    </ads>
</searchResult>
New Json
{
    "total": 1813062,
    "currentPage": 1,
    "maxPages": 20,
    "pageSize": 100,
    "ads": []
}

If your search results contain more than 2000 ads and you need to access the remaining data, please refine your query by adding more parameters, such as the price filter, to limit the results.

Error response

The Search API returns an HTTP status code of 400 (Bad Request) for errors attributable to the user.

To identify the exact issue, inspect the response body, which contains a list of error elements, each associated with an error key. Additionally, there may be an optional message attribute offering a localized description of the error key.

Legacy XML Example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <error:errors xmlns:error="http://services.mobile.de/schema/common/error-1.0">
    <error:error key="invalid-search-parameter" message="Invalid search parameter">
      <error:args key="field">exteriorColor</error:args>
      <error:args key="code">typeMismatch</error:args>
      <error:args key="rejected-value">BLACK11,RED</error:args>
    </error:error>
</error:errors>

New JSON Example:

{
    "errors": [
        {
            "key": "invalid-search-parameter",
            "message": "Invalid search parameter",
            "args": [
                {
                    "key": "field",
                    "value": "exteriorColor"
                },
                {
                    "key": "code",
                    "value": "typeMismatch"
                },
                {
                    "key": "rejected-value",
                    "value": "Black1"
                }
            ]
        }
    ]
}

New XML Example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<errorResponse>
    <errors>
        <error>
            <key>invalid-search-parameter</key>
            <message>Invalid search parameter</message>
            <args>
                <arg>
                    <key>field</key>
                    <value>exteriorColor</value>
                </arg>
                <arg>
                    <key>code</key>
                    <value>typeMismatch</value>
                </arg>
                <arg>
                    <key>rejected-value</key>
                    <value>Black1</value>
                </arg>
            </args>
        </error>
    </errors>
</errorResponse>

Search Parameters

  • You can send multiple comma-separated values for all search parameters with type Set.

  • It’s important to note that using only numeric and boolean search parameters isn’t allowed. Your request must include at least one parameter with a type different from numeric or boolean.

Parameter Type Description/Example

page.number

int

page number of result set - it starts with 1

page.size

int

default: 20, max size 100

sort.field

String

The name of the field to sort. Must be combined with sort.order.
Example: https://services.mobile.de/search-api/search?country=DE&sort.field=modificationTime&sort.order=DESCENDING
Sorting by make and model: There is a special sort order field name which has no similar search parameter equivalent called "makeModel". This results in a combined order of make and model. Example: https://services.mobile.de/search-api/search?country=DE&sort.field=makeModel&sort.order=ASCENDING

sort.order

String

Possible Values are ASCENDING, DESCENDING
Example: sort.order=ASCENDING

customerNumber

Set(Long)

Search for vehicles of specific sellers defined by customerNumber.

  • What is a customer number? A customer number identifies a dealer seller (not private FSBO seller). The customerId is something else.

  • Some API user may only see ads of a defined set of delaer sellers. You do not need to add this search parameter to comply to these restrictions. It is done automatically.

  • If you specify both parameters (customerNumber and customerId) then the customerId parameter is ignored.

customerId

Set(Long)

Search for vehicles of specific sellers defined by customer ID.

  • What is a customer ID? A customer ID identifies a dealer seller or a private FSBO seller. The customerNumber (only for dealers) is something else.

  • Some API user may only see ads of a defined set of delaer sellers. You do not need to add this search parameter to comply to this restrictions. It is done automatically.

  • If you specify both parameters (customerNumber and customerId) then the customerId parameter is ignored. Example: https://services.mobile.de/search-api/search?customerId=471738

classification

Set(String)

Classification is used to define the make/model or make/modelgroup combination for cars. It is also possible to use this parameter to specify a certain vehicle class. The definition of a make is possible for all vehicles with this parameter.
For vehicle classes other than Car, please use "modelDescription" instead of "classification" and "model"
Example search for AUDI A8: https://services.mobile.de/search-api/search?classification=refdata/classes/Car/makes/AUDI/models/A8
Example search for BMW X-Reihe: https://services.mobile.de/search-api/search?classification=refdata/classes/Car/makes/BMW/modelgroups/X__BMW_SERIES
Example search for Motorbikes with the String "Classic" in model description: https://services.mobile.de/search-api/search?classification=refdata/classes/Motorbike&modelDescription=Classic

category

Set(enum)

feature

Set(enum)

excludeFeature

Set(enum)

condition

Set(enum)

exteriorColor

Set(enum)

emissionClass

Set(enum)

fuel

Set(enum)

climatisation

Set(enum)

emissionSticker

Set(enum)

Example search for vehicles with green emissionsticker (Germany only): https://services.mobile.de/search-api/search?emissionSticker=EMISSIONSSTICKER_GREEN
Possible values: https://services.mobile.de/refdata/emissionstickers

gearbox

Set(enum)

Example search for vehicles with semi-automatic gearshift: https://services.mobile.de/search-api/search?gearbox=SEMIAUTOMATIC_GEAR
Possible values: https://services.mobile.de/refdata/gearboxes

usageType

Set(enum)

drivingMode

Set(enum)

Example search for motorbikes with belt transmission (only available for Motorbikes): https://services.mobile.de/search-api/search?drivingMode=BELT_DRIVE
Possible values: https://services.mobile.de/refdata/drivingmodes

modelDescription

String

Search for vehicles with "right hand drive" in model description: https://services.mobile.de/search-api/search?modelDescription=right%20hand%20drive

price.min

decimal

Minimum price(gros price) in EUR
Search for vehicles over 5000 EUR: https://services.mobile.de/search-api/search?price.min=5000&classification=refdata/classes/Car

price.max

decimal

Maximum price(gros price) in EUR
Search for vehicles under 10000 EUR: https://services.mobile.de/search-api/search?price.max=10000&classification=refdata/classes/Car

vatable

bool

Use vatable=1 for get all vehicles where VAT is vatable
Search for vehicles under 10000 EUR with VAT vatable: https://services.mobile.de/search-api/search?vatable=1&price.min=10000&classification=refdata/classes/Car

country

ISO-3166-1 alpha-2

Example search for all vehicles from Austrian sellers: https://services.mobile.de/search-api/search?country=AT
Possible values: http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

firstRegistrationDate.min

Example search for all vehicles with a first Registration in 01.2007 or later: https://services.mobile.de/search-api/search?firstRegistrationDate.min=2007-01&classification=refdata/classes/Car

firstRegistrationDate.max

Example search for all vehicles with a first Registration earlier than 01.1971: https://services.mobile.de/search-api/search?firstRegistrationDate.max=1971-01&classification=refdata/classes/Car

constructionYear.min

int, YYYY

constructionYear.max

int, YYYY

modificationTime.min

Example search for all vehicles/ads modified after a specific time: modificationTime.min=2008-05-04T18:13:51%2B01:00&classification=refdata/classes/Car ormodificationTime.min=2008-05-04&classification=refdata/classes/Car
Note: If the time zone passed, the '+' character must be URL encoded. Pass "2008-05-04T18:13:51+01:00" as "2008-05-04T18:13:51%2B01:00"

modificationTime.max

Example search for all vehicles/ads modified before a specific time: modificationTime.max=2008-05-04T18:13:51%2B01:00&classification=refdata/classes/Car ormodificationTime.max=2008-05-04&classification=refdata/classes/Car
Note: If the time zone passed, the '+' character must be URL encoded. Pass "2008-05-04T18:13:51+01:00" as "2008-05-04T18:13:51%2B01:00"

creationTime.min

Example search for all vehicles/ads created after a specific time: creationTime.min=2008-05-04T18:13:51%2B01:00&classification=refdata/classes/Car orcreationTime.min=2008-05-04&classification=refdata/classes/Car
Note: If the time zone passed, the '+' character must be URL encoded. Pass "2008-05-04T18:13:51+01:00" as "2008-05-04T18:13:51%2B01:00"

creationTime.max

Example search for all vehicles/ads created before a specific time: creationTime.max=2008-05-04T18:13:51%2B01:00&classification=refdata/classes/Car orcreationTime.max=2008-05-04&classification=refdata/classes/Car
Note: If the time zone passed, the '+' character must be URL encoded. Pass "2008-05-04T18:13:51+01:00" as "2008-05-04T18:13:51%2B01:00"

damageUnrepaired

bool

Use damageUnrepaired=0 to suppress damaged and unrepaired vehicles. Please see Damaged, Accident, Roadworthy for more details.
Do not specify this parameter when you search for vehicle classes that do not have this information set (AgriculturalVehicle, ConstructionMachine, ForkliftTruck, SemiTrailer and Trailer).
Search for damaged and unrepaired vehicles under 1000 EUR: https://services.mobile.de/search-api/search?damageUnrepaired=1&vatable=1&price.min=1000&classification=refdata/classes/Car

accidentDamaged

bool

The vehicle once had an accident which may be repaired or not. Please see Damaged, Accident, Roadworthy for more details.
Example search for cars that are accident free https://services.mobile.de/search-api/search?accidentDamaged=1&classification=refdata/classes/Car

roadworthy

bool

The vehicle is ready to drive. Please see Damaged, Accident, Roadworthy for more details.
Example search for cars that are ready to drive https://services.mobile.de/search-api/search?roadworthy=1&classification=refdata/classes/Car

mileage.min

int

Minimum mileage in kilometers Example search for vehicles with mileage over 100.000 kilometers: https://services.mobile.de/search-api/search?mileage.min=100000&classification=refdata/classes/Car

mileage.max

int

Maximum mileage in kilometers Example search for vehicles with mileage under 40.000 kilometers: https://services.mobile.de/search-api/search?mileage.max=40000&classification=refdata/classes/Car

power.min

decimal

Minimum power in kilowatt (kW)
Example search for vehicles with power over 75kW: https://services.mobile.de/search-api/search?power.min=75&classification=refdata/classes/Car

power.max

decimal

Maximum power in kilowatt (kW)
Example search for vehicles with power less than 30kW: https://services.mobile.de/search-api/search?power.max=30&classification=refdata/classes/Car

liftingCapacity.min

int

Minimum lifting capacity for commercial vehicles in kilogramm (kg)
Example search for vehicles with a minimum lifting capacity of 500kg: https://services.mobile.de/search-api/search?liftingCapacity.min=500&classification=refdata/classes/Car

liftingCapacity.max

int

Maximum lifting capacity for commercial vehicles in kilogramm (kg)
Example search for vehicles with a maximum lifting capacity of 1000kg: https://services.mobile.de/search-api/search?liftingCapacity.max=1000&classification=refdata/classes/ForkliftTruck

installationHeight.min

int

Minimum installation height for forklift trucks in mm
Example search for vehicles with a minimum installation height of 2m (2000mm): https://services.mobile.de/search-api/search?installationHeight.min=2000&classification=refdata/classes/ForkliftTruck

installationHeight.max

int

Maximum installation height for forklift trucks in mm
Example search for vehicles with a maximum installation height of 3m (3000mm): https://services.mobile.de/search-api/search?installationHeight.max=3000&classification=refdata/classes/ForkliftTruck

operatingHours.min

int

Minimum value of operating hours for construction machines in h
Example search for vehicles with a minimum of 300 operating hours: https://services.mobile.de/search-api/search?operatingHours.min=300&classification=refdata/classes/ConstructionMachine

operatingHours.max

int

Maximum value of operating hours for construction machines in h
Example search for vehicles with a minimum of 500 operating hours: https://services.mobile.de/search-api/search?operatingHours.max=500&classification=refdata/classes/ConstructionMachine

liftingHeight.min

int

Minimum lifting height for forklift trucks in mm
Example search for vehicles with a minimum lifting height of 5m (5000mm): https://services.mobile.de/search-api/search?liftingHeight.min=5000&classification=refdata/classes/ForkliftTruck

liftingHeight.max

int

Maximum lifting height for forklift trucks in mm
Example search for vehicles with a maximum lifting height of 3m (3000mm): https://services.mobile.de/search-api/search?liftingHeight.max=3000&classification=refdata/classes/ForkliftTruck

axles.min

int

Minimum number of axles for commercial vehicles
Example search for vehicles with a minimum of 4 axles: https://services.mobile.de/search-api/search?axles.min=4&classification=refdata/classes/TruckOver7500

axles.max

int

Maximum number of axles for commercial vehicles
Example search for vehicles with a maximum of 8 axles: https://services.mobile.de/search-api/search?axles.min=8&classification=refdata/classes/TruckOver7500

loadCapacity.min

int

Minimum load capacity for trailers and semi-trailers in kg
Example search for trailers with a minimum load capacity of 2.5t(2500kg): https://services.mobile.de/search-api/search?loadCapacity.min=2500&classification=refdata/classes/Trailer

loadCapacity.max

int

Maximum load capacity for trailers and semi-trailers in kg
Example search for trailers and semi-trailers with a maximum load capacity of 20t(20.000kg): https://services.mobile.de/search-api/search?loadCapacity.max=20000&classification=refdata/classes/Trailer

cubicCapacity.min

int

Minimum cubic capacity for motorbikes in ccm
Example search for bikes with a minimum cubic capacity of 125 ccm: https://services.mobile.de/search-api/search?cubicCapacity.min=125&classification=refdata/classes/Motorbike

cubicCapacity.max

int

Maximum cubic capacity for motorbikes in ccm
Example search for bikes with a maximum cubic capacity of 1000ccm: https://services.mobile.de/search-api/search?cubicCapacity.max=1000&classification=refdata/classes/Motorbike

numSeats.min

int

Number of min passenger seats
Example search for vehicles with 2-3 seats: https://services.mobile.de/search-api/search?numSeats.min=2&numSeats.max=3&classification=refdata/classes/Car

numSeats.max

int

Number of max passenger seats
Example search for vehicles with 2-3 seats: https://services.mobile.de/search-api/search?numSeats.min=2&numSeats.max=3&classification=refdata/classes/Car

deliveryPeriod.min

int

Minimum number of days until a vehicle is available
Example search for vehicles available in 3 days or later: https://services.mobile.de/search-api/search?deliveryPeriod.min=3&classification=refdata/classes/Car

deliveryPeriod.max

int

Maximum number of days until a vehicle is available
Example search for vehicles available in 14 days or earlier: https://services.mobile.de/search-api/search?deliveryPeriod.max=14&classification=refdata/classes/Car

sellerType

String

Defines the type of seller
Possible Values are FOR_SALE_BY_OWNER, DEALER
Example search for all Bentleys advertised by private sellers only: https://services.mobile.de/search-api/search?sellerType=FOR_SALE_BY_OWNER&classification=refdata/classes/Car/makes/Bentley

doorCount

Set(enum)

drivingCab

Set(enum)

licensedWeight.min

int

licensedWeight.max

int

wheelFormula

Set(enum)

ambit.zipcode

String

Zipcode for regional search. Currently only available in Germany; only valid German zip codes are accepted.
Example: all cars within a 10 kilometer radius of zip code 14532 https://services.mobile.de/search-api/search?classification=refdata/classes/Car&ambit.zipcode=14532&ambit.radius=10

ambit.radius

int

Radius size in kilometers for regional search. Default value is 0.

ambit.country

ISO-3166-1 alpha-2

Country code for regional search. Default is DE (currently, the only accepted value).

imageCount.min

int

Minimum number of images attached to the ad
Example search for car ads with a minimum of 1 images: https://services.mobile.de/search-api/search?imageCount.min=1&classification=refdata/classes/Car

imageCount.max

int

Maximum number of images attached to the ad
Example search for car ads with a maximum of 4 images: https://services.mobile.de/search-api/search?imageCount.max=4&classification=refdata/classes/Car

numberOfPreviousOwners.min

int

Minimum number of previous owners
Example search for car ads with a minimum of 1 previous owners: https://services.mobile.de/search-api/search?numberOfPreviousOwners.min=1&classification=refdata/classes/Car

numberOfPreviousOwners.max

int

Maximum number of previous owners
Example search for car ads with a maximum of 3 previous owners: https://services.mobile.de/search-api/search?numberOfPreviousOwners.max=3&classification=refdata/classes/Car

monthsTillInspection

int

Minimum number of months till next inspection
Example search for car ads with an inspection not earlier than in 6 months: https://services.mobile.de/search-api/search?monthsTillInspection=6&classification=refdata/classes/Car

interiorColor

Set(enum)

interiorType

Set(enum)

airbag

Set(enum)

parkingAssistant

Set(enum)

countryVersion

Set(enum)

Example search for vehicles that were manufactured for German or French market: https://services.mobile.de/search-api/search?countryVersion=DE,FR
Possible values: http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

speedControl

Set(enum)

radio

Set(enum)

daytimeRunningLamps

Set(enum)

slidingDoor

Set(enum)

headlightType

Set(enum)

bendingLightsType

Set(enum)

breakdownService

Set(enum)

battery

Set(enum)

batteryCapacity.min

int

Minimum battery capacity for vehicles in kWh. (0 < x < 1000) kWh
Example search for electric vehicles with a minimum batterry capacity of 5 kWh: https://services.mobile.de/search-api/search?batteryCapacity.min=500

batteryCapacity.max

int

Maximum battery capacity for vehicles in kWh. (0 < x < 1000) kWh
Example search for electric vehicles with a maximum batterry capacity of 50 kWh: https://services.mobile.de/search-api/search?batteryCapacity.max=50

trailerCouplingType

Set(enum)

numberOfGears.min

Int

numberOfGears.max

Int

frameShape

Set(enum)

frameHeight.min

Int

Minimum frame height of EBike
Example search for EBike with 30-60 frame height: https://services.mobile.de/search-api/search?frameHeight.min=30&frameHeight.max=60&classification=refdata/classes/EBike

frameHeight.max

Int

Maximum frame height of EBike
Example search for EBike with 30-60 frame height: https://services.mobile.de/search-api/search?frameHeight.min=30&frameHeight.max=60&classification=refdata/classes/EBike

frameMaterial

Set(enum)

wheelSize

String

Wheel size of EBike
Example search for EBike with 20-24 wheel size: https://services.mobile.de/search-api/search?wheelSize=24&classification=refdata/classes/EBike

batteryCapacityWh.min

Int

Minimum battery capacity of EBike
Example search for EBike with 250-700 Wh battery capacity: https://services.mobile.de/search-api/search?batteryCapacityWh.min=250&batteryCapacityWh.max=700&classification=refdata/classes/EBike

batteryCapacityWh.max

Int

Maximum battery capacity of EBike
Example search for EBike with 250-700 Wh battery capacity: https://services.mobile.de/search-api/search?batteryCapacityWh.min=250&batteryCapacityWh.max=700&classification=refdata/classes/EBike

weight.min

Int

Minimum weight of EBike
Example search for EBike with 8-30 kg weight: https://services.mobile.de/search-api/search?weight.min=8&weight.max=20&classification=refdata/classes/EBike

weight.max

Int

Maximum weight of EBike
Example search for EBike with 8-30 kg weight: https://services.mobile.de/search-api/search?weight.min=8&weight.max=20&classification=refdata/classes/EBike

bikeGearType

Set(enum)

batteryManufacturer

Set(enum)

bikeSuitableFor

Set(enum)

motorPosition

Set(enum)

batteryPosition

Set(enum)

Data Format

The SearchAPI offers support for three data formats:

  • New JSON (Accept: application/vnd.de.mobil.api+json)

  • New XML (Accept: application/vnd.de.mobil.api+xml)

  • Legacy XML (Accept: application/xml)

Both the new JSON and new XML formats share the same schema in terms of field names and types. You can find detailed descriptions of field names and types in the Data Format Reference.

For those utilizing the legacy XML schema, it’s described in the Legacy XML schema files (Deprecated).

New Json Finding Ads Sample Response
{
    "total": 16,
    "currentPage": 1,
    "maxPages": 16,
    "pageSize": 1,
    "ads": [
        {
            "mobileAdId": "15012",
            "mobileSellerId": "11",
            "creationDate": "2024-04-26T02:35:10+02:00",
            "modificationDate": "2024-05-15T16:08:18+02:00",
            "vehicleClass": "Car",
            "category": "EstateCar",
            "make": "ABARTH",
            "model": "500",
            "modelDescription": "500",
            "condition": "USED",
            "firstRegistration": "202007",
            "mileage": 500,
            "fuel": "DIESEL",
            "damageUnrepaired": false,
            "plainTextDescription": "",
            "detailPageUrl": "https://suchen.mobile.de/auto-inserat/abarth-500-w-stheuterode/15012.html?source=api",
            "seller": {
                "mobileSellerId": "00",
                "email": "someemail@email.email",
                "geoData": {
                    "lon": 01.0000000,
                    "lat": 01.0000000
                },
                "phones": [],
                "address": {
                    "zipcode": "00000",
                    "city": "some city",
                    "country": "DE"
                },
                "type": "DEALER",
                "commercial": true,
                "dealerLogo": {
                    "icon": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-80.jpg",
                    "s": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-200.jpg",
                    "m": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-240.jpg",
                    "l": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-360.jpg",
                    "xl": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-640.jpg",
                    "xxl": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1024.jpg",
                    "xxxl": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1600.jpg"
                }
            },
            "price": {
                "consumerPriceGross": "1000.00",
                "type": "FIXED",
                "currency": "EUR"
            }
        }
    ]
}
New XML Finding Ads Sample Response
<?xml version="1.0" encoding="UTF-8"?>
<searchResult>
    <total>16</total>
    <currentPage>1</currentPage>
    <maxPages>16</maxPages>
    <pageSize>1</pageSize>
    <ads>
        <ad>
            <mobileAdId>15012</mobileAdId>
            <mobileSellerId>11</mobileSellerId>
            <creationDate>2024-04-26T02:35:10+02:00</creationDate>
            <modificationDate>2024-05-15T16:08:18+02:00</modificationDate>
            <vehicleClass>Car</vehicleClass>
            <category>EstateCar</category>
            <make>ABARTH</make>
            <model>500</model>
            <modelDescription>500</modelDescription>
            <condition>USED</condition>
            <firstRegistration>202007</firstRegistration>
            <mileage>500</mileage>
            <fuel>DIESEL</fuel>
            <damageUnrepaired>false</damageUnrepaired>
            <plainTextDescription></plainTextDescription>
            <detailPageUrl>https://suchen.mobile.de/auto-inserat/abarth-500-w-stheuterode/15012.html?source=api</detailPageUrl>
            <seller>
                <mobileSellerId>00</mobileSellerId>
                <email>someemail@email.email</email>
                <geoData>
                    <lon>01.0000000</lon>
                    <lat>01.0000000</lat>
                </geoData>
                <phones></phones>
                <address>
                    <zipcode>00000</zipcode>
                    <city>some city</city>
                    <country>DE</country>
                </address>
                <type>DEALER</type>
                <commercial>true</commercial>
                <dealerLogo>
                    <icon>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-80.jpg</icon>
                    <s>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-200.jpg</s>
                    <m>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-240.jpg</m>
                    <l>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-360.jpg</l>
                    <xl>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-640.jpg</xl>
                    <xxl>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1024.jpg</xxl>
                    <xxxl>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1600.jpg</xxxl>
                </dealerLogo>
            </seller>
            <price>
                <consumerPriceGross>1000.00</consumerPriceGross>
                <type>FIXED</type>
                <currency>EUR</currency>
            </price>
        </ad>
    </ads>
</searchResult>
Legacy XML Finding Ads Sample Response
<?xml version="1.0" encoding="UTF-8"?>
<search:search-result xmlns:error="http://services.mobile.de/schema/common/error-1.0" xmlns:financing="http://services.mobile.de/schema/common/financing-1.0" xmlns:ad="http://services.mobile.de/schema/ad" xmlns:resource="http://services.mobile.de/schema/resource" xmlns:search="http://services.mobile.de/schema/search" xmlns:seller="http://services.mobile.de/schema/seller" xmlns:leasing="http://services.mobile.de/schema/common/leasing-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://services.mobile.de/schema/search http://services.mobile.de/schema/search-1.0.xsd">
    <search:total>16</search:total>
    <search:page-size>1</search:page-size>
    <search:current-page>1</search:current-page>
    <search:max-pages>16</search:max-pages>
    <search:ads>
        <ad:ad key="15012" url="https://services.mobile.de/search-api/ad/15012">
            <ad:creation-date value="2024-04-26T02:35:10+02:00"/>
            <ad:modification-date value="2024-05-15T16:08:18+02:00"/>
            <ad:detail-page url="https://suchen.mobile.de/auto-inserat/abarth-500-w-stheuterode/15012.html?source=api"/>
            <ad:vehicle>
                <ad:class key="Car" url="https://services.mobile.de/refdata/classes/Car">
                    <resource:local-description xml-lang="en">Car</resource:local-description>
                </ad:class>
                <ad:category key="EstateCar" url="https://services.mobile.de/refdata/classes/Car/categories/EstateCar">
                    <resource:local-description xml-lang="en">Estate Car</resource:local-description>
                </ad:category>
                <ad:make key="ABARTH" url="https://services.mobile.de/refdata/classes/Car/makes/ABARTH">
                    <resource:local-description xml-lang="en">Abarth</resource:local-description>
                </ad:make>
                <ad:model key="500" url="https://services.mobile.de/refdata/classes/Car/makes/ABARTH/models/500">
                    <resource:local-description xml-lang="en">500</resource:local-description>
                </ad:model>
                <ad:model-description value="500"/>
                <ad:damage-and-unrepaired value="false"/>
                <ad:specifics>
                    <ad:mileage value="500"/>
                    <ad:first-registration value="2020-07"/>
                    <ad:fuel key="DIESEL" url="https://services.mobile.de/refdata/fuels/DIESEL">
                        <resource:local-description xml-lang="en">Diesel</resource:local-description>
                    </ad:fuel>
                    <ad:condition key="USED" url="https://services.mobile.de/refdata/conditions/USED">
                        <resource:local-description xml-lang="en">Used vehicle</resource:local-description>
                    </ad:condition>
                </ad:specifics>
            </ad:vehicle>
            <ad:description></ad:description>
            <ad:price currency="EUR" type="FIXED">
                <ad:consumer-price-amount value="1000.00"/>
                <ad:vatable value="false"/>
            </ad:price>
            <seller:seller key="00" url="https://services.mobile.de/search-api/seller/00">
                <seller:type value="DEALER" commercial="true"/>
                <seller:address>
                    <seller:zipcode value="00000"/>
                    <seller:city value="some city"/>
                    <seller:country-code value="DE"/>
                </seller:address>
                <seller:email value="someemail@email.email"/>
                <seller:coordinates>
                    <seller:latitude>01.0000000</seller:latitude>
                    <seller:longitude>01.0000000</seller:longitude>
                </seller:coordinates>
            </seller:seller>
        </ad:ad>
    </search:ads>
</search:search-result>
New Json Fetch single ads by an ad-key Sample Ad Response
{
    "mobileAdId": "15012",
    "mobileSellerId": "11",
    "creationDate": "2024-04-26T02:35:10+02:00",
    "modificationDate": "2024-05-15T16:08:18+02:00",
    "vehicleClass": "Car",
    "category": "EstateCar",
    "make": "ABARTH",
    "model": "500",
    "modelDescription": "500",
    "condition": "USED",
    "firstRegistration": "202007",
    "mileage": 500,
    "fuel": "DIESEL",
    "costModel": {
        "timeFrame": {},
        "co2Costs": {}
    },
    "damageUnrepaired": false,
    "plainTextDescription": "",
    "detailPageUrl": "https://suchen.mobile.de/auto-inserat/abarth-500-w-stheuterode/15012.html?source=api",
    "seller": {
        "mobileSellerId": "00",
        "mobileSellerSince": "2014-03-24T23:00:00Z",
        "email": "someemail@email.email",
        "geoData": {
            "lon": 01.0000000,
            "lat": 01.0000000
        },
        "companyName": "Some Company Name",
        "phones": [
            {
                "internationalPrefix": 49,
                "nationalPrefix": "001",
                "number": "0000000"
            },
            {
                "internationalPrefix": 49,
                "nationalPrefix": "002",
                "number": "0000000"
            }
        ],
        "cell": {
            "internationalPrefix": 49,
            "nationalPrefix": "003",
            "number": "0000000"
        },
        "fax": {
            "internationalPrefix": 49,
            "nationalPrefix": "004",
            "number": "0000000"
        },
        "address": {
            "street": "Some Strasse",
            "zipcode": "00000",
            "city": "Some City",
            "country": "DE"
        },
        "type": "DEALER",
        "commercial": true,
        "homepage": "https://home.mobile.de/home/redirect.html?customerId=00",
        "dealerLogo": {
            "icon": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-80.jpg",
            "s": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-200.jpg",
            "m": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-240.jpg",
            "l": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-360.jpg",
            "xl": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-640.jpg",
            "xxl": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1024.jpg",
            "xxxl": "https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1600.jpg"
        }
    },
    "price": {
        "consumerPriceGross": "1000.00",
        "type": "FIXED",
        "currency": "EUR"
    }
}
New XML Fetch single ads by an ad-key Sample Ad Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ad>
    <mobileAdId>15012</mobileAdId>
    <mobileSellerId>11</mobileSellerId>
    <creationDate>2024-04-26T02:35:10+02:00</creationDate>
    <modificationDate>2024-05-15T16:08:18+02:00</modificationDate>
    <vehicleClass>Car</vehicleClass>
    <category>EstateCar</category>
    <make>ABARTH</make>
    <model>500</model>
    <modelDescription>500</modelDescription>
    <condition>USED</condition>
    <firstRegistration>202007</firstRegistration>
    <mileage>500</mileage>
    <fuel>DIESEL</fuel>
    <costModel>
        <timeFrame/>
        <co2Costs/>
    </costModel>
    <damageUnrepaired>false</damageUnrepaired>
    <plainTextDescription></plainTextDescription>
    <detailPageUrl>https://suchen.mobile.de/auto-inserat/abarth-500-w-stheuterode/15012.html?source=api</detailPageUrl>
    <seller>
        <mobileSellerId>11</mobileSellerId>
        <mobileSellerSince>2014-03-24T23:00:00Z</mobileSellerSince>
        <email>someemail@email.email</email>
        <geoData>
            <lon>01.0000000</lon>
            <lat>01.0000000</lat>
        </geoData>
        <companyName>Some Company Name</companyName>
        <phones>
            <phone>
                <internationalPrefix>49</internationalPrefix>
                <nationalPrefix>001</nationalPrefix>
                <number>0000000</number>
            </phone>
            <phone>
                <internationalPrefix>49</internationalPrefix>
                <nationalPrefix>002</nationalPrefix>
                <number>0000000</number>
            </phone>
        </phones>
        <cell>
            <internationalPrefix>49</internationalPrefix>
            <nationalPrefix>003</nationalPrefix>
            <number>0000000</number>
        </cell>
        <fax>
            <internationalPrefix>49</internationalPrefix>
            <nationalPrefix>004</nationalPrefix>
            <number>0000000</number>
        </fax>
        <address>
            <street>Some Strasse</street>
            <zipcode>00000</zipcode>
            <city>Some City</city>
            <country>DE</country>
        </address>
        <type>DEALER</type>
        <commercial>true</commercial>
        <homepage>https://home.mobile.de/home/redirect.html?customerId=00</homepage>
        <dealerLogo>
            <icon>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-80.jpg</icon>
            <s>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-200.jpg</s>
            <m>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-240.jpg</m>
            <l>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-360.jpg</l>
            <xl>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-640.jpg</xl>
            <xxl>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1024.jpg</xxl>
            <xxxl>https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1600.jpg</xxxl>
        </dealerLogo>
    </seller>
    <price>
        <consumerPriceGross>1000.00</consumerPriceGross>
        <type>FIXED</type>
        <currency>EUR</currency>
    </price>
</ad>
Legacy Xml Fetch single ads by an ad-key Sample Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ad:ad xmlns:resource="http://services.mobile.de/schema/resource" xmlns:ad="http://services.mobile.de/schema/ad" xmlns:financing="http://services.mobile.de/schema/common/financing-1.0" xmlns:leasing="http://services.mobile.de/schema/common/leasing-1.0" xmlns:seller="http://services.mobile.de/schema/seller" key="15012" url="https://services.mobile.de/search-api/ad/15012">
    <ad:creation-date value="2024-04-26T02:35:10+02:00"/>
    <ad:modification-date value="2024-05-15T16:08:18+02:00"/>
    <ad:detail-page url="https://suchen.mobile.de/auto-inserat/abarth-500-w-stheuterode/15012.html?source=api"/>
    <ad:vehicle>
        <ad:class key="Car" url="https://services.mobile.de/refdata/classes/Car">
            <resource:local-description xml-lang="en">Car</resource:local-description>
        </ad:class>
        <ad:category key="EstateCar" url="https://services.mobile.de/refdata/classes/Car/categories/EstateCar">
            <resource:local-description xml-lang="en">Estate Car</resource:local-description>
        </ad:category>
        <ad:make key="ABARTH" url="https://services.mobile.de/refdata/classes/Car/makes/ABARTH">
            <resource:local-description xml-lang="en">Abarth</resource:local-description>
        </ad:make>
        <ad:model key="500" url="https://services.mobile.de/refdata/classes/Car/makes/ABARTH/models/500">
            <resource:local-description xml-lang="en">500</resource:local-description>
        </ad:model>
        <ad:model-description value="500"/>
        <ad:damage-and-unrepaired value="false"/>
        <ad:specifics>
            <ad:mileage value="500"/>
            <ad:first-registration value="2020-07"/>
            <ad:fuel key="DIESEL" url="https://services.mobile.de/refdata/fuels/DIESEL">
                <resource:local-description xml-lang="en">Diesel</resource:local-description>
            </ad:fuel>
            <ad:condition key="USED" url="https://services.mobile.de/refdata/conditions/USED">
                <resource:local-description xml-lang="en">Used vehicle</resource:local-description>
            </ad:condition>
            <ad:cost-model>
                <ad:co2-costs/>
            </ad:cost-model>
        </ad:specifics>
    </ad:vehicle>
    <ad:description></ad:description>
    <ad:price currency="EUR" type="FIXED">
        <ad:consumer-price-amount value="1000.00"/>
        <ad:vatable value="false"/>
    </ad:price>
    <seller:seller key="11" url="https://services.mobile.de/search-api/seller/00">
        <seller:type value="DEALER" commercial="true"/>
        <seller:company-name value="Some Company Name"/>
        <seller:address>
            <seller:street value="Some Strasse"/>
            <seller:zipcode value="00000"/>
            <seller:city value="Some City"/>
            <seller:country-code value="DE"/>
        </seller:address>
        <seller:phone type="FIXED" country-calling-code="49" area-code="001" number="000000"/>
        <seller:phone type="FIXED" country-calling-code="49" area-code="002" number="000000"/>
        <seller:phone type="CELL" country-calling-code="49" area-code="002" number="000000"/>
        <seller:phone type="FAX" country-calling-code="49" area-code="003" number="000000"/>
        <seller:email value="smoke.location@test.de"/>
        <seller:homepage value="https://home.mobile.de/home/redirect.html?customerId=11"/>
        <seller:mobile-seller-since value="2014-03-25+01:00"/>
        <seller:coordinates>
            <seller:latitude>01.000000</seller:latitude>
            <seller:longitude>01.000000</seller:longitude>
        </seller:coordinates>
        <seller:logo-image>
            <seller:representation size="S" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-200.jpg"/>
            <seller:representation size="XL" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-640.jpg"/>
            <seller:representation size="ICON" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-80.jpg"/>
            <seller:representation size="L" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-360.jpg"/>
            <seller:representation size="M" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-240.jpg"/>
            <seller:representation size="XXL" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1024.jpg"/>
            <seller:representation size="XXXL" url="https://img.classistatic.de/api/v1/mo-nonprod/images/ad/adac0001-1874-4c8c-ad4f-8decda8dbd09?rule=mo-1600.jpg"/>
        </seller:logo-image>
        <seller:contact-languages>
            <seller:language>de</seller:language>
            <seller:language>fr</seller:language>
            <seller:language>en</seller:language>
        </seller:contact-languages>
    </seller:seller>
</ad:ad>

References

Resources Reference

This section contains a detailed description of all rest apis provided by the Search API.

Please note the that below endpoints are available on the following base url:

Please refer to the Introduction paragraph to get more information how to access the api.

Name Method Endpoint

Fetch single ads by an ad-key

GET

/search-api/ad/{ad-key}

Finding Ads

GET

/search-api/search?{search-parameters}

Data Format Reference

This section describes various aspects of the data exchanged through the api calls.

Data Types Reference

This section contains a detailed definition of the data produced by Search API. The data consists of a number of fields and each field is of certain type. A type could be a simple value such as String or Int or a complex type that groups logically other fields.

The below sections contain explanation of all the fields and how they are grouped together into types.

Legacy XML schema files (Deprecated)

  • Please check the Legacy XML schema definition of our data format to understand the response returned by this API.

Resource data type (parent for many other types)

resource-1.0.xsd

Search result

search-1.0.xsd

Ad data (standalone or part of a search result)

ad-1.0.xsd

Seller data (part of an ad)

seller-1.0.xsd

Leasing data (part of an ad, only if leasing applicable to ad)

leasing-1.0.xsd

New Data Format (New Json/XML)

SearchResult

Field Name Type Description

total

Int

The total number of results.

maxPages

Int

The total number of results-pages.

pageSize

Int

The number of results per page

currentPage

Int

The current page number.

ads

Collection of Ad

The ad results (of this page).

errors

Error

A list of non fatal errors related to this search request e.g. invalid or deprecated search parameters. If this list is present then the search result might not be as intended by the client, so always check that this not present.

Ad

Top level type for representing Ad data.

Field Name Type Description

PLATFORM METADATA

mobileAdId

String

mobile-platform Ad ID

mobileSellerId

String

mobile-platform Seller ID

creationDate

String

e.g. 2015-06-12T11:58:32+02:00. See Date Time Representation for details.

modificationDate

String

e.g. 2015-06-12T11:58:32+02:00. See Date Time Representation for details.

VEHICLE

Key Fields

vehicleClass

String

The GENERAL classification of vehicles e.g. Car or Motorbike. See vehicle classes for possible values.

category

String

The DETAILED classification of vehicles e.g. Cabrio or Limousine. See categories for possible values.

make

String

Make of the vehicle e.g. Mercedes, Toyota. See makes for possible values.

model

String

Model of the vehicle e.g. X5, Prius. See models for possible values.

modelDescription

String

Detailed description of the model. Also used as ad title. Example Golf III always parked in garage. This field is restricted to a subset of UTF-8 characters.

condition

String

Is the vehicle new or used? See conditions for possible values.

usageType

String

Type of used car. See usage types for possible values.

firstRegistration

String

yyyyMM. See Date Time Representation for details.

mileage

Int

mileage in km

vin

String

The vehicle identification number (aka VIN or FIN). See http://en.wikipedia.org/wiki/Vehicle_Identification_Number. The field is case sensitive. Please send capital letters.

internalNumber

String

A reference key used by the seller. Also known as internal-number or internal-ID. If it is present, then it must be unique per seller. An empty string is treated same as if the element was not present. This field is restricted to a subset of UTF-8 characters.

Engine / Drive Train

cubicCapacity

Int

Cubic-capacity of the engine. Notation integer.

power

Int

Power of the vehicle. Notation in KW

gearbox

String

Stickshift, automatic? See gear boxes for possible values.

fuel

String

Type of fuel. See fuel for possible values.

axles

Int

Number of axles, integer. Information only for commercial vehicles

fourWheelDrive

Boolean

Four wheel drive

wheelFormula

String

The actuation of the vehicle. See wheel formulas for possible values.

hybridPlugin

Boolean

A plug-in hybrid electric vehicle (PHEV) is a hybrid electric vehicle that uses rechargeable batteries, or another energy storage device, that can be recharged by plugging it in to an external source of electric power.

e10Enabled

Boolean

is the vehicle enabled for using E10 fuel

catalyticConverter

Boolean

Catalytic converter - motorcycles only

particulateFilterDiesel

Boolean

Particulate filter diesel

biodieselConversion

Boolean

Biodiesel conversion

biodieselSuitable

Boolean

Biodiesel suitable - Biodiesel suitable, only for diesel fuel - Biodiesel geeignet

vegetableoilfuelConversion

Boolean

Vegetableoilfuel conversion

vegetableoilfuelSuitable

Boolean

Vegetableoilfuel suitable - only cars and semi trailer trucks, only diesel fuel

performanceHandlingSystem

Boolean

Performance handling system - (Sportfahrwerk)

startStopSystem

Boolean

Start stop system

envkvCompliant

Boolean

If the vehicle is compliant with German legal requirements (EnVKV)

energyEfficiencyClass

String

the label for the applicable class of energy consumption, ranges between A+++, A++, A+, A, B, C, D, E, F or G

co2

Float

Indicates the amount of carbon dioxide emissions in grams per kilometer traveled.

consumptionInner

Float

Fuel consumption as measured in specific tests executed in city traffic situations. Number in l/100km (natural gas (CNG) in kg/100km, is ignored for electric vehicles)

consumptionOuter

Float

Fuel consumption as measured in specific tests executed in highway traffic situations. Number in l/100km (natural gas (CNG) in kg/100km, is ignored for electric vehicles)

consumptionCombined

Float

Fuel consumption as measured in specific tests executed in city and highway traffic situations. Number in l/100km (natural gas (CNG) in kg/100km, electric vehicles in kWh/100km)

consumptionUnit

String

The unit of the consumption values. This element is only readonly. For write usecases the unit is derived from the fuel type. fuel consumption units

envkvPetrolType

String

When you want to provide EnVKV compliant values, for fuel type petrol, you have to specify the exact petrol type, that the consumption values are based on. petrol types

consumptionPowerCombined

Float

Combined power consumption for electric vehicles in in kWh/100km

emissionSticker

String

Emission sticker for German low emission zones (Feinstaubplakette für Umweltzone). See emission stickers for possible values.

emissionClass

String

EURO 1, 2, 3, 4, …​. See emission classes for possible values.

wltpValues

WltpValues

Additional values from WLTP (Worldwide Harmonised Light-Duty Vehicles Test Procedure)

equivalentAllElectricRange

Int

WLTP electric range (EAER) in km (only for plugin hybrids)

emissions

Emissions

Emission values, legally required for new cars

consumptions

Consumptions

Consumption values, legally required for new cars

costModel

CostModel

Cost Model values, legally required for new cars

range

Int

electric range in km.

Exterior / Interior

exteriorColor

String

The mobile.de color name. This is a fixed set of colors. colors for possible values

manufacturerColorName

String

free text field for color. This field is restricted to a subset of UTF-8 characters.

metallic

Boolean

Metallic

doors

String

Number of doors. See door counts for possible values.

seats

Int

number of seats. For categories Car, Bus, Truck up to 7,5t.

interiorColor

String

Information about the color of the interior of the vehicle. See interior colors for possible values.

interiorType

String

Information about the material used in the interior of the vehicle. See interior types for possible values.

Facts

generalInspection

String

yyyyMM. See Date Time Representation for details.

exhaustInspection

String

yyyyMM. See Date Time Representation for details.

newHuAu

Boolean

Buyer get’s a new HU/AU

constructionYear

Int

Format yyyy. Information only for commercial vehicles

constructionDate

String

The day when the vehicle was built. See Date Time Representation for details.

numberOfPreviousOwners

Int

Information about the number of previous owners of the vehicle

fullServiceHistory

Boolean

Full service history - (Scheckheftgeplfegt)

nonSmokerVehicle

Boolean

Nonsmoker vehicle

countryVersion

String

ISO-3166-1 alpha-2 code of the country for which the vehicle was built. See country versions for possible values. For newcars this field is mandatory.

damageUnrepaired

Boolean

See http://services.mobile.de/manual/damage.html

accidentDamaged

Boolean

See http://services.mobile.de/manual/damage.html (available only for cars)

roadworthy

Boolean

See http://services.mobile.de/manual/damage.html (available only for cars)

taxi

Boolean

Usable if the car is or was a taxi

Vehicle Details

abs

Boolean

Abs

airbag

String

Information about the airbags of the vehicle. See airbags for possible values.

airSuspension

Boolean

Air suspension

alloyWheels

Boolean

Alloy wheels

automaticRainSensor

Boolean

Rain sensor

auxiliaryHeating

Boolean

Auxiliary heating

awning

Boolean

An awning or overhang is a secondary covering attached to the exterior wall of a building.

bed

Boolean

Bed

bluetooth

Boolean

Bluetooth

box

Boolean

Box

bss

Boolean

Boom Suspension System

bunkBed

Boolean

Bunk bed

cabin

Boolean

Cabin

cdMultichanger

Boolean

CD multichanger

cdPlayer

Boolean

CD Player

centralLocking

Boolean

Central locking

centralLubricantApplication

Boolean

A system that delivers controlled amounts of lubricant to multiple locations on a machine while the machine is operating.

circularSeatingArrangement

Boolean

Circular seating arrangement

climatisation

String

Information on the climatisation of the vehicle. See climatisations for possible values.

coldstore

Boolean

Fridge

compressor

Boolean

Compressor

crane

Boolean

Crane

damageByHail

Boolean

Damage by hail

dimension

Dimension

The external dimension of the vehicle.

disabledAccessible

Boolean

Disabled accessible

disabledConversion

Boolean

Disabled conversion

discBrake

Boolean

Disc brake

divider

Boolean

Divider

driversSleepingCompartment

Boolean

Drivers sleeping compartment

drivingCab

String

Information about the cab of the truck. See driving cabs for possible values.

drivingMode

String

Does the motorbike have a chain or something else? See driving modes for possible values.

ebs

Boolean

Electronic Braking System

electricAdjustableSeats

Boolean

Electric adjustable seats

electricExteriorMirrors

Boolean

Electric mirrors

electricHeatedSeats

Boolean

Electric heated seats

electricStarter

Boolean

Electric starter

electricWindows

Boolean

Electric windows

esp

Boolean

Esp

europalletStorageSpaces

Int

Information about how many europallets suit in the vehicle.

frontFogLights

Boolean

Front fog lights

frontHydraulics

Boolean

Front hydraulics

frontJack

Boolean

Front Jack for Accessoires

fullFairing

Boolean

Full fairing increases effiency

handsFreePhoneSystem

Boolean

Hands free phone system

headUpDisplay

Boolean

Headup display

hydraulicInstallation

String

Indicates the type of hydraulic installation. See hydraulic installations for possible values.

immobilizer

Boolean

Immobilizer

installationHeight

Int

Notation in mm, integer. Information only for commercial vehicles

isofix

Boolean

ISOFIX is the international standard for attachment points for child safety seats in passenger cars

kickstarter

Boolean

Kickstarter - motorcycles only

kitchen

Boolean

Kitchen

licensedWeight

Int

Notation in kg, integer. Information only for commercial vehicles.

liftingCapacity

Int

Notation in kg, integer. Information only for commercial vehicles

liftingHeight

Int

Notation in mm, integer. Information only for commercial vehicles

lightSensor

Boolean

Light sensor

loadCapacity

Int

Notation in kg, integer. Information only for commercial vehicles

loadingSpace

Dimension

The loading space dimensions.

middleSeatingArrangement

Boolean

Middle seating arrangement

multifunctionalWheel

Boolean

Multifunctional wheel

municipal

Boolean

Municipal

navigationSystem

Boolean

Is the car having a build in navigation system. Not be be set for portable navigation systems

numberOfBunks

Int

The number of bunks. Only for Motorhome.

onBoardComputer

Boolean

On board computer

operatingHours

Int

Notation integer. Information only for commercial vehicles

panoramicGlassRoof

Boolean

Panoramic glass roof

parkingAssistants

Collection of String

Information about the parking assistants of the vehicle. parking assistants for possible values.

speedControl

String

Information about the speed control of the vehicle. See speed controls for possible values.

radio

Collection of String

Information about the radio of the vehicle. See radios for possible values.

daytimeRunningLamps

String

Information about the type of daytime running lamps of the vehicle. See daytime running lamps for possible values.

slidingDoorType

String

Information about the type of sliding door of the vehicle. See sliding door types for possible values.

headlightType

String

Information about the headlight types of the vehicle. See headlight types for possible values.

bendingLightsType

String

Information about the type of cornering/bending lights of the vehicle. See bending lights types for possible values.

breakdownService

String

Information about the type of breakdown service kit of the vehicle. See breakdown services for possible values.

battery

String

Information about the battery of the electric vehicle. See batteries for possible values.

trailerCouplingType

String

Information about the trailer coupling type of the vehicle. See trailer coupling types for possible values.

trimLine

String

Information about the trim line a.k.a feature sets (Ausstattungslinie) of the vehicle. See trimlines.

modelRange

String

Information about the model range a.k.a. Baureihe of the vehicle. See modelranges.

firstModelsProductionDate

String

yyyyMM. See Date Time Representation for details.

batteryCapacity

Int

Battery capacity of the vehicle. Notation in kWh, integer

powerAssistedSteering

Boolean

Power assisted steering

protectionRoof

Boolean

Protection roof

quickChangeAttachment

Boolean

Quick change attachment

rearGarage

Boolean

Rear garage

retarder

Boolean

Used if the vehicle has an retader or intarder

roadLicence

Boolean

Road licence

rollOverBar

Boolean

Roll over bar

roofRails

Boolean

Roofrails

secondaryAirConditioning

Boolean

Secondary air conditioning - (Standklimaanlage)

sepShower

Boolean

Seperate Shower

shippingVolume

Int

The loading space volume. Notation in cubic meter

sideSeatingArrangement

Boolean

Side seating arrangement

skiBag

Boolean

Ski bag

sleepSeats

Boolean

Sleep seats

solarEnergySystem

Boolean

Solar energy system

sportPackage

Boolean

Sport package

sportSeats

Boolean

Sport seats

sunroof

Boolean

Sunroof

superSingleWheels

Boolean

Super single wheels

tailLift

Boolean

Tail lift

tractionControlSystem

Boolean

Traction control system

tv

Boolean

Tv

ureaTankAdBlue

Boolean

Urea tank ad blue

wc

Boolean

Toilet

windshield

Boolean

Windshield

alarmSystem

Boolean

The vehicle makes itself heard / seen, if someone tries to break into the car

armRest

Boolean

Arm rest between driver and front passenger seat

heatedWindshield

Boolean

Windshield has heating elements integrated (dedicated blowers to heat windshield are not to be considered as heated windshield)

heatedSteeringWheel

Boolean

Steering wheel can be heated

hillStartAssist

Boolean

Could be Hill Holder, Hill Hold Control or Hill Start Assist as well. A system to automatically support the driver when starting up from a stop on an up or down gradient

electricTailgate

Boolean

tailgate is able to be operated electrically, either from the driver position, with a button on the tailgate or from a key fob as some examples

leatherSteeringWheel

Boolean

Steering wheel is covered with leather

lumbarSupport

Boolean

Mechanism within at least the drivers seat which supports the back of a person during longer drives

massageSeats

Boolean

At least driver seat has an active massage functionality

fatigueWarningSystem

Boolean

Vehicle warns driver if they get tired

nightVisionAssist

Boolean

The vehicle supports the driver while driving at night. It might show heat signatures of larger living things and might warn the driver if there could be a collision possibility

emergencyCallSystem

Boolean

Vehicle is able to initiate (automatically) an emergency call if in an accident

tirePressureMonitoring

Boolean

Tire pressure is (constantly) measured and reported by the vehicle

paddleShifters

Boolean

It is possible to change gears with paddles at the steering wheel

electricHeatedRearSeats

Boolean

Rear passenger seats can be heated

soundSystem

Boolean

Vehicle has a better sound system compared to the standard audio system of this model

voiceControl

Boolean

Certain aspects of a car (usually hands free phone system) can be controlled by voice

touchscreen

Boolean

Certain aspects of the car, usually the entertainment system, have a touch screen interface

usb

Boolean

The vehicle has a USB port in the passenger area, usually for connecting a media player or smart phone to the entertainment system or for charging devices

trafficSignRecognition

Boolean

Vehicle is able to recognize traffic signs and show the recognized signs to the driver

highBeamAssist

Boolean

Vehicle recognizes oncoming traffic and switches between high and low beam

summerTires

Boolean

Vehicle does include summer tires. This does not have to include rims

winterTires

Boolean

Vehicle does include winter tires. This does not have to include rims

allSeasonTires

Boolean

Vehicle does include all season tires. This does not have to include rims

steelWheels

Boolean

Vehicle does include steel rims. The vehicle might include steel and alloy rims, together with summer and winter tires, this would be a complete 8 tire set

glareFreeHighBeam

Boolean

High beam is able to mask oncoming traffic automatically. This is not to be mistaken for high beam assist.

headlightWasherSystem

Boolean

system to clean main front headlights

winterPackage

Boolean

Package usually named with any manufacturer winter package

smokersPackage

Boolean

Package usually named with any manufacturer smoker´s package. Might include things like ashtrays or cigarette lighters

distanceWarningSystem

Boolean

Vehicle tries to prevent a collision with other vehicles or objects by warning the driver

electricBackseatAdjustment

Boolean

Back Passanger Seats are electrically adjustable

ambientLighting

Boolean

(various) parts of the vehicle interior can be lighted with soft lights during driving. Color of those lights might be able to be changed

wifiHotspot

Boolean

Vehicle has an integrated WiFi Hotspot and probable Internet connection to allow passengers to use WiFi devices

carplay

Boolean

Vehicles entertainment system supports Apples CarPlay system. This allows an iPhone to take over the user interface of the entertainment systems (in part)

androidAuto

Boolean

Vehicles entertainment system supports Android Auto system. This allows an Android Phone to take over the user interface of the entertainment systems (in part)

digitalCockpit

Boolean

There are no dedicated, single purpose instruments behind the steering wheel. The whole area is a screen and can be adjusted to the drivers requirements.

passengerSeatIsofixPoint

Boolean

Front passager seat has Isofix connection points for anchoring a child seat

wirelessCharging

Boolean

Vehicle has the capability to inductively charge a smartphone for example via the Qi standard

integratedMusicStreaming

Boolean

Vehicle has a streaming service client (e.g. Spotify client) integrated to play music via this streaming service without a smart phone being present

dimmingInteriorMirror

Boolean

Interior monitor dims automatically if it senses to much light coming from following vehicles

foldFlatPassengerSeat

Boolean

Front passager seat is completely foldable allowing for transporting longer items

cargoBarrier

Boolean

It is possible to have a stable barrier between the cargo area / trunk and passenger area, e.g. with a net

speedLimiter

Boolean

The vehicle provides the possibility to set a speed limit, the driver usually is able to override this speed limit for example by pressing the gas pedal harder

rangeExtender

Boolean

Electric vehicle has a petrol support motor charging the battery if it is empty. Main engine(s) are driven with electrical power

collisionAvoidance

Boolean

Vehicle tries to prevent a collision with other vehicles or objects by warning the driver and enforcing an emergency break or supporting the breaking effort of the driver

keylessEntry

Boolean

Vehicle doors can be opened without a key. This could be done with pressing a button on a key fob or automatically by proximity

ventilatedSeats

Boolean

At least driver seat is ventilated

laneDepartureWarning

Boolean

Vehicle tries to either actively (vehicle steers itself) or passively (warns driver if lane is left) to keep itself in a lane

blindSpotMonitor

Boolean

Vehicle warns the driver, if there are objects in the blind spots of the car

numberOfGears

Int

Information about the number of EBike gears, integer, Only for EBikes

frameShape

String

Information about the frame shape of the EBike. See frame shapes for possible values. Only for EBikes

frameMaterial

String

Information about the frame material of the EBike. See frame materials for possible values. Only for EBikes

batteryPosition

String

Information about the battery position of the EBike. battery positions for possible values. Only for EBikes

batteryManufacturer

String

Information about the battery manufacturer of the EBike. See battery manufacturers for possible values. Only for EBikes

motorPosition

String

Information about the motor position of the EBike. See motor positions for possible values. Only for EBikes

bikeSuitableFor

String

Information about for whom the EBike is suitable for. See bike suitable for for possible values. Only for EBikes

bikeGearType

String

Information about the gear type of the EBike. See bike gear types for possible values. Only for EBikes

wheelSize

String

Information about the wheel size of EBike, Free text, Only for EBikes

frameHeight

Int

Information about the frame height of the EBike, integer, Only for EBikes

batteryCapacityWh

Int

Battery capacity of the EBike. Notation in Wh, integer, Only for EBikes

frameNumber

String

The number of EBike Frame, Free text

weight

Int

Information about the Weight of EBike, integer, Only for EBikes

Description / Images / Video

description

String

Free text description of the vehicle.

plainTextDescription

String

vehicle description in plain text.

images

Collection of Image

List of images

videoUrl

String

Youtube url in youtube.com/xxx format

highlights

Collection of String

Short notes highlighting key features of the vehicle.

detailPageUrl

String

URL pointing to the detail page of this ad.

seller

Seller

Contact data.

Catalog Data

kba

Kba

Germany only, Classification of makes and models, given by Kraftfahrtbundesamt (KBA)

schwackeCode

Int

Classification of makes and models given by Eurotax/Schwacke

OFFER

deliveryDate

String

Date when the vehicle is ready to be delivered to the customer, e.g. 2015-06-12. See Date Time Representation for details.

deliveryPeriod

Int

Time-span in days until the vehicle is ready to be delivered. Information only for new vehicles. Allowed Values: 1, 2, 3, 4, 5, 6, 7, 14, 42, 60, 90, 120, 150, 180, 270 and 360

usedCarSeal

String

Information and restrictions about Used-Car-Seals can be found here. Not visible to all users. See used car seals for possible values.

dealerHomepage

Boolean

Visible as featured item on the dealers homepage ("Unsere Empfehlung")

closedDomain

Boolean

Visible only in closed domain not in public domain

export

Boolean

No private Selling offer, only for commercial or export

warranty

Boolean

Vehicle is sold including additional warranty on top of the statutory warranty that is mandatory when selling to private persons.

rentingPossible

Boolean

Renting possible

price

Price

Price information. Check details of the Price type for more information.

financing

Financing

Financing offer information. Check details of the Financing type for more information.

leasing

Leasing

Information on leasing conditions.

Deprecated Fields

Financing

Field Name Type Description

annualPercentageRate

String

Percentage. AKA rate-per-cent (seller-ad-1.1.xsd), effektiver Jahreszins (German). Must be between 0 and 19.99 and can only have two digits after comma.

nominalInterestRate

String

Percentage. AKA nominal-interest-rate (seller-ad-1.1.xsd), Sollzinssatz (German).

typeOfNominalInterestRate

String

AKA type-of-nominal-interest-rate (seller-ad-1.1.xsd), Art des Sollzinssatzes (German). nominal interest rate types

firstInstallment

Int

A nonrecurring payment at the beginning of the payback period. Currency is the same as the vehicle price. AKA Anzahlung (German).

monthlyInstallment

Int

The monthly recurring payment. Currency is the same as the vehicle price. AKA monthly-rate (seller-ad-1.1.xsd), monatliche Rate (German).

finalInstallment

Int

A nonrecurring payment at the end of the payback period. Currency is the same as the vehicle price. AKA ending-rate (seller-ad-1.1.xsd), Schlussrate (German).

paybackPeriod

String

Duration in months. AKA period (seller-ad-1.1.xsd), Laufzeit in Monaten (German). payback periods

netLoanAmount

String

Currency is the same as the vehicle price. AKA net-credit-amount (seller-ad-1.1.xsd), Nettokreditbetrag (German).

grossLoanAmount

String

Currency is the same as the vehicle price. AKA gross-credit-amount (seller-ad-1.1.xsd), Bruttokreditbetrag (German).

closingCosts

String

A fee for placing the loan contract. Currency is the same as the vehicle price. AKA Abschlussgebühren (German).

paymentProtectionInsurance

String

Costs of such insurance. Currency is the same as the vehicle price. AKA rate-insurance (seller-ad-1.1.xsd), Ratenabsicherung (EUR) (German).

bank

String

Description of the bank. AKA Anbieterbank (German) max. 150 characters.

conditions

String

Description of further conditions. max. 60 characters.

comment

String

Leasing comment, will show up in leasing description for the potential buyer

Leasing

The currency fields are represented as String using the . as decimal separator with two digits precision. The fields should be parsed using arbitrary rounding strategy.

Field Name Type Description

grossListPrice

Int

Price of the vehicle for other dealers including VAT if reclaimable. Only visible in dealer area.

vatRate

String

The VAT rate as percent number.

lender

String

Name of the lender / leasing bank.

rates

Collection of LeasingRate

List of leasing rates. At least one PRIVATE rate is required.

comment

String

Leasing comment, will show up in leasing description for the potential buyer.

LeasingRate

Leasing Rate.

Field Name Type Description

type

LeasingType

Target group of this leasing rate.

downPayment

Int

This is the amount the buyer needs to pay at the beginning of the leasing contract.

termOfContract

Int

This is the length of the leasing contract in months.

annualMileage

Int

Annual mileage in KM. At least one rate for type PRIVATE with 10000km annual mileage is mandatory for a leasing offer.

grossRate

String

The rate the buyer needs to pay in a given month during the contract period. It includes the German VAT rate, as these offers are currently only for customers in Germany. (Required for type PRIVATE)

netRate

String

Net leasing rate, see above (not including VAT for commercial leasing). (Required for type COMMERCIAL)

netLoanAmount

String

Net loan amount (in German Nettodarlehnbetrag). (Required for type PRIVATE)

totalAmount

String

This is the total amount the buyer needs to pay over the length of the contract. Usually this is the rate times the number of months in the contract duration.

annualPercentageRate

String

Annual percentage rate, (in German Effektiver Jahreszins). (Required for type PRIVATE)

nominalInterestRate

String

Nominal interest rate (in German Sollzins p.a.) (Required for type PRIVATE)

destinationCharges

String

Destination charges / freight costs. These are the costs the buyer needs to pay for freight costs (in German Überführungskosten). If it is "0.00", we will display charges, including to the buyer. This field is optional (we will show, "no information available" to the buyer by default).

registrationFees

String

Registration fees (in German Zulassungskosten). Same rules as for Destination Charges.

extraMileageCosts

String

Extra mileage costs, (in German Mehrkilometer Kosten). The costs a buyer needs to pay at the end of the contract if they have incurred a higher mileage than allowed for in the leasing contract.

lowMileageCompensation

String

Low mileage compensation, (in German Minderkilometer Erstattung). The amount a buyer gets returned at the end of the contract if they have incurred a lower mileage than agreed for in the leasing contract.

Price

The currency fields are represented as String using the . as decimal separator with two digits precision. The fields should be parsed using arbitrary rounding strategy.

Field Name Type Description

dealerPriceGross

String

Price of the vehicle for other dealers including VAT if reclaimable. Only visible in dealer area.

consumerPriceGross

String

Price of the vehicle for private buyers including VAT if reclaimable. This is the main price shown.

dealerPriceNet

String

Net price of the vehicle for other dealers. Can only be used when providing a VAT rate as gross price is calculated then. Only visible in dealer area.

consumerPriceNet

String

Net price of the vehicle for private buyers. Can only be used when providing a VAT rate as gross price is calculated then. price type explanation of values price types

vatRate

String

The VAT rate as percent number (a number between 0 and 100). For example 19. When you add this attribute then your vehicle is displayed as VAT deductible. See vat rates

type

String

For AgricultureVehicle, Bus, ConstructionMachine, ForkliftTruck, SemiTrailer, SemiTrailerTruck, Trailer, TruckOver7500, VanUpTo7500 it is possible to set price type ON_REQUEST. In that case price element must only contain the price type. The following price types are possible price types. FIXED is the default value.

currency

String

Information in which currency the price is stated. During upload this field is ignored and the currency taken from the sellers site-ID instead.

Image

Field Name Type Description

hash

String

MD5 checksum of the original uploaded customer image

icon

String

url to the 80x60 image

s

String

url to the 200x150 image

m

String

url to the 240x180 image (298 x 244 until Q2 2022)

l

String

url to the 360x270 image (400 x 300 until Q2 2022)

xl

String

url to the 640x480 image

xxl

String

url to the 1024x768 image

xxxl

String

url to the 1600x1200 image

Images

Field Name Type Description

images

Collection of Image

List of images

Dimension

Field Name Type Description

length

Int

Length. Notation in mm

width

Int

Width. Notation in mm

height

Int

Height. Notation in mm

Kba

Field Name Type Description

hsn

String

Germany only, Herstellerschlüsselnummer

tsn

String

Germany only, Typschlüsselnummer

Seller

Field Name Type Description

mobileSellerId

String

mobile-platform Seller ID

mobileSellerSince

String

e.g. 2015-06-12T11:58:32+02:00.

email

String

Contact email.

geoData

GeoData

Geolocation of the seller.

firstName

String

First name of a private seller.

lastName

String

Last name of a private seller.

companyName

String

Legal name for commercial sellers.

nameVisible

Boolean

When set to 'false' the customers name won’t be displayed in its ads.

phoneNumberVisible

Boolean

When set to 'false' the customers phone number won’t be shown in its ads.

phones

Collection of Phone

Contact phone numbers.

cell

Phone

Contact cell phone number.

fax

Phone

Contact fax number.

address

Address

Address.

type

String

Commercial or private seller.

commercial

Boolean

Commercial or non-profit seller.

homepage

String

Url to the seller home pgae.

dealerLogoBaseUrl

String

DEPRECATED - use dealerLogo instead

dealerLogo

Image

dealer logo

GeoData

Field Name Type Description

lon

Double

Longitude - decimal representation.

lat

Double

Latitude - decimal representation.

Phone

Field Name Type Description

internationalPrefix

Int

County code.

nationalPrefix

String

Area code.

number

String

Phone number.

Address

Field Name Type Description

street

String

Address.

houseNumber

String

additionalAddressInfo

String

Address.

zipcode

String

Address.

city

String

Address.

country

String

Address - notation http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.

WltpValues

Field Name Type Description

co2EmissionCombined

Float

Amount of carbon dioxide emissions in g/km for all vehicles, optional for plugin hybrids.

co2EmissionCombinedWeighted

Float

Weighted amount of carbon dioxide emissions in g/km for plugin hybrids

consumptionPowerCombined

Float

Combined power consumption for electric vehicles in in kWh/100km

consumptionPowerCombinedWeighted

Float

Weighted combined power consumption for plugin hybrids in kWh/100km

consumptionFuelCombined

Float

Combined fuel consumption for all nonelectric vehicles, optional for plugin hybrids, number in l/100km (natural gas (CNG) in kg/100km)

consumptionFuelCombinedWeighted

Float

Weighted combined fuel consumption for plugin hybrids

electricRange

Int

Electric Range for plugin hybrids and electric vehicles in km

Emissions

Field Name Type Description

combined

Emission

Combined (in case of plugin hybrid → combined/weighted) emission values

discharged

Emission

Emission values for plugin hybrid when battery is discharged

Emission

Field Name Type Description

co2

String

CO₂ emission value in g/100 km.

co2Class

String

CO₂ class. This property can have the following values → A, B, C, D, E, F, G

Consumptions

Field Name Type Description

weightedCombinedFuel

String

WLTP weighted/combined fuel consumption value. Only for plugin hybrid.

weightedCombinedPower

String

WLTP weighted/combined power consumption value. Only for plugin hybrid.

fuel

Consumption

WLTP fuel consumption values. In case of plugin hybrid → fuel consumption when battery is discharged.

power

Consumption

WLTP electrical power consumption values. For plugin hybrid → electrical power consumption in pure electric mode.

Consumption

Field Name Type Description

combined

String

energy consumption combined.

city

String

energy consumption inner city.

suburban

String

energy consumption in the outskirts of city.

rural

String

energy consumption on country roads.

highway

String

energy consumption on highways.

CostModel

Field Name Type Description

fuelPrice

String

Assumed price of fuel in EUR per liter or kg

powerPrice

String

Assumed price of electricity in EUR per kWh

consumptionCosts

String

Predicted energy (fuel and power) costs in EUR for an annual mileage of 15,000 km.

consumptionPriceYear

Int

Year of which the average fuel and power prices are based upon

tax

String

Annual vehicle tax in EUR

timeFrame

TimeFrame

The time frame for the predictions being made.

co2Costs

Co2Costs

Predicted CO₂ costs in EUR"

TimeFrame

Field Name Type Description

from

Int

The start year for the predictions being made

till

Int

The end year for the predictions being made

Co2Costs

Field Name Type Description

low

Co2Cost

model for low CO₂ prices

high

Co2Cost

model for high CO₂ prices

middle

Co2Cost

model for middle CO₂ prices

Co2Cost

Field Name Type Description

basePrice

String

The possible CO₂ cost in EUR/t

accumulated

String

The possible accumulated CO₂ cost in EUR for the next 10 years and 15.000 km annual mileage

ErrorResponse

Top level type that describes api call failure

Field Name Type Description

errors

Collection of Error

List of errors. For example a list of missing fields that are required for given operation.

Error

Describes an api error.

Field Name Type Description

key

String

Indicates a type of problem - e.g. missing required field or invalid field value

message

String

Human readable error description

args

Collection of Arg

List of key-value pairs detailing the failure

Arg

Field Name Type Description

key

String

Key of detailed error

value

String

Description of detailed error

LeasingType

Possible Value Description

PRIVATE

Leasing rate is offered to private persons.

COMMERCIAL

Leasing rate is offered to commercial entities, could be a single person or a company.

Date Time Representation

This part contains general information regarding how to work with date/time based fields in the APIs of mobile.de.

Date Time

The datetime information is represented as text that conforms to the ISO_8601 standard. It is formatted using the Europe/Berlin time zone offset, for example 2015-12-01T18:40:44+01:00.

Json example
{
    "creationDate": "2015-12-01T18:40:44+01:00"
}
Xml example
    <creationDate>2015-12-01T18:40:44+01:00</creationDate>

Month and Year

Some fields require only year and month precision. They are represented as text using yyyyMM format.

Example
{
    "firstRegistration": "200909",
    "generalInspection": "201611"
}

Year

The fields that require information only about the year are represented as a number using yyyy format.

Example
{
    "constructionYear": 2010
}

Reference Data

Reference data is a set of tables that define valid values for a number of fields such as colors, makes, models and others.

Base url

The base url for the reference data endpoints is:

Authentication is not required for reference data endpoints.

Media Type

The reference data is exposed using Legacy-Xml, New Json and New Xml representation. Please refer to MediaTypes section for more details.

Legacy Xml request

GET /refdata/petroltypes HTTP/1.1
Accept: application/xml

Legacy Xml response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<reference:reference xmlns:seller="http://services.mobile.de/schema/seller" xmlns:ad="http://services.mobile.de/schema/ad" xmlns:financing="http://services.mobile.de/schema/common/financing-1.0" xmlns:reference="http://services.mobile.de/schema/reference" xmlns:resource="http://services.mobile.de/schema/resource" xmlns:leasing="http://services.mobile.de/schema/common/leasing-1.0">
    <reference:item key="SUPER_PLUS" url="https://services.mobile.de/refdata/petroltypes/SUPER_PLUS">
        <resource:local-description xml-lang="de">Super Plus</resource:local-description>
    </reference:item>
    <reference:item key="SUPER" url="https://services.mobile.de/refdata/petroltypes/SUPER">
        <resource:local-description xml-lang="de">Super</resource:local-description>
    </reference:item>
    <reference:item key="NORMAL" url="https://services.mobile.de/refdata/petroltypes/NORMAL">
        <resource:local-description xml-lang="de">Normal</resource:local-description>
    </reference:item>
</reference:reference>

New Xml request

GET /refdata/petroltypes HTTP/1.1
Accept: application/vnd.de.mobile.api+xml

New Xml response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<refList>
    <values>
        <refType>
            <name>SUPER_PLUS</name>
            <description>Super Plus</description>
            <url>https://services.mobile.de/refdata/petroltypes/SUPER_PLUS</url>
        </refType>
        <refType>
            <name>SUPER</name>
            <description>Super</description>
            <url>https://services.mobile.de/refdata/petroltypes/SUPER</url>
        </refType>
        <refType>
            <name>NORMAL</name>
            <description>Normal</description>
            <url>https://services.mobile.de/refdata/petroltypes/NORMAL</url>
        </refType>
    </values>
</refList>

New Json request

GET /refdata/petroltypes HTTP/1.1
Accept: application/vnd.de.mobile.api+json

New Json response

{
    "values": [
        {
            "name": "SUPER_PLUS",
            "description": "Super Plus",
            "url": "https://services.mobile.de/refdata/petroltypes/SUPER_PLUS"
        },
        {
            "name": "SUPER",
            "description": "Super",
            "url": "https://services.mobile.de/refdata/petroltypes/SUPER"
        },
        {
            "name": "NORMAL",
            "description": "Normal",
            "url": "https://services.mobile.de/refdata/petroltypes/NORMAL"
        }
    ]
}

Internationalization Support

The reference data is localized. Specifying the Accept-Language header controls the language of the output.

Localized request

GET /refdata/gearboxes HTTP/1.1
Accept: application/vnd.de.mobile.api+json
Accept-Language: de

Localized response

{
  "values": [
    {
      "name": "MANUAL_GEAR",
      "description": "Schaltgetriebe"
    },
    {
      "name": "SEMIAUTOMATIC_GEAR",
      "description": "Halbautomatik"
    },
    {
      "name": "AUTOMATIC_GEAR",
      "description": "Automatik"
    }
  ]
}

Reference Data Types

Site Id

List of supported Site Ids

Type Endpoint

site

Site Dependent Types

Some reference data may depend on the Site Id or could be based on some other types e.g. list of models depends on selected make. The endpoints are parametrized using path parameters. Furthermore, there is a site independent resource which contains all summarized site specific values and resources.

Type Endpoint (site independent and site specific)

class

/refdata/classes
/refdata/sites/:siteId/classes Example

category

/refdata/classes/:class/categories Example
/refdata/sites/:siteId/classes/:class/categories Example

make

/refdata/classes/:class/makes Example
/refdata/sites/:siteId/classes/:class/makes Example

model

/refdata/classes/:class/makes/:make/models Example
/refdata/:siteId/classes/:class/makes/:make/models Example

model group

/refdata/classes/:class/makes/:make/modelgroups Example
/refdata/sites/:siteId/classes/:class/makes/:make/modelgroups Example

model of a model group

/refdata/classes/:class/makes/:make/modelgroups/:modelgroup/models Example
/refdata/sites/:siteId/classes/:class/makes/:make/modelgroups/:modelgroup/models
Example

usedcarseal

/refdata/sites/:siteId/classes/:class/usedcarseals Example

vatrate

/refdata/sites/:siteId/vatrates Example

modelrange

/refdata/sites/:siteId/classes/:class/makes/:make/models/:model/modelranges?firstregistration=YYYYMM Example
query parameters
- firstregistration= YYYYMM (required)
- category= one of categories
- fuel= one of fuel
- doorcount= one of door counts
- trimline= one of trimlines

trimline

/refdata/sites/:siteId/classes/:class/makes/:make/models/:model/trimlines?firstregistration=YYYYMM Example
query parameters
- firstregistration= YYYYMM (required)
- category= one of categories
- fuel= one of fuel
- doorcount= one of door counts
- modelrange= one of modelranges

Site Independent Reference Data

Table Endpoint

airbag

batteryManufacturer

battery

batteryPosition

bendingLightsType

bikeGearType

bikeSuitableFor

breakdownService

climatisation

color

condition

countryVersion

daytimeRunningLamps

doorCount

drivingCab

drivingModes

emissionClass

emissionSticker

frameMaterial

frameShape

fuelConsumptionUnit

fuel

gearbox

headlightType

hydraulicInstallation

interiorColor

interiorType

motorPosition

nominalInterestRateType

parkingAssistant

paybackPeriod

petrolType

plugType

priceRating

priceType

radio

slidingDoorType

speedControl

trailerCouplingType

usageType

wheelFormula

Support

Customer Support Contact

Please contact the Customer Support team if you need further assistance.

Country Contact Details

Germany

Phone: +49 (0) 30 81097500 or Contact Form