Insights API Documentation

Table of Contents

Introduction
Access and Testing
Performance Comparison
Popular Search Criteria
- Fetch Single Ad Popular Search Criteria
  - Request
  - Response
- Possible Search Criteria
  - Core Filters
  - Feature Filters
Sales Probability
References
Resources Reference
Data Format Reference
- Data Types Reference
- Data Format
Support
Customer Support Contact

Introduction

The Insights API gives dealers actionable benchmarks by comparing their listing to similar vehicles on mobile.de. It aggregates key performance metrics, such as listing performance comparison, sales probability and reveals the underlying comparison set with their attributes. With these insights, dealers can optimize listings and make confident, data-driven decisions.

Access to the Insights API features is currently available exclusively to partners participating in the mobile.de Data Partner Program. If you’re interested in joining the program or want to learn more about eligibility and onboarding, please contact your Strategic Partner Manager (Partner Management Team). For evaluation, you can use the Sandbox and SwaggerUI to test before joining the program.

Insights API offers the following data points:

Performance Comparison
- Fetch Single Ad Performance Comparison
- Fetch Performance Comparison Bulk Endpoint
Popular Search Criteria
- Fetch Single Ad Popular Search Criteria
Sales Probability
- Fetch Single Ad Sales Probability
- Fetch Sales Probability Bulk Endpoint

Access and Testing

Authentication and Authorization

The API is available at this base URL:

https://services.mobile.de

In order to upload listings on behalf of mobile.de customers you’ll need to register as an API user on the mobile.de platform. Please contact the Customer Support for further details about the activation process!

The user must be authenticated with a username and password using the HTTP basic authentication scheme. For detailed information on HTTP basic authentication see

During the activation process the Customer Support will provide you with instructions how to get the access credentials. The credentials are unique for each API user and do not dependent on sellers or ads.

API Sandbox

The Insights API sandbox returns mock data intended for integration testing. Sandbox payloads, labels, and distributions are not representative of live production data and will differ from the values observed in production.

For testing purposes, an API sandbox environment is available. Interactive Swagger documentation is also available for exploring and testing the APIs.

https://services.sandbox.mobile.de

The sandbox only offers the full functionality of the following apis:

Getting a Test Account

The API test account can be requested by email to service@team.mobile.de. The email should state that you request an API User account for the API Sandbox environment. Including your project and your requirements.

Media Types

The API supports data retrieval in Json and 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
Json	Accept: `application/vnd.de.mobile.api+json`

HTTP header fields

HTTP header field	Possible values	Description
Accept	application/vnd.de.mobile.api+json	Selects Json as output format
Authorization	Basic (base64 encode username:password)	The username and password are combined with a colon (e.g., username:password) and then encoded using Base64. For HTTP Basic Authentication, you need to explicitly send this header or configure your client to use Basic Auth to transmit the username and password.

HTTP header field

Possible values

Description

application/vnd.de.mobile.api+json

Selects Json as output format

Authorization

Basic (base64 encode username:password)

The username and password are combined with a colon (e.g., username:password) and then encoded using Base64. For HTTP Basic Authentication, you need to explicitly send this header or configure your client to use Basic Auth to transmit the username and password.

Swagger documentation

Swagger Production documentation:

Open https://services.mobile.de/insights-api/openapi-docs
In the 'Servers' section, choose https://services.mobile.de/insights-api
Click on 'Authorize' button and enter your credentials
Test all the APIs

Swagger Sandbox documentation:

Open https://services.sandbox.mobile.de/insights-api/openapi-docs
In the 'Servers' section, choose https://services.sandbox.mobile.de/insights-api
Click on 'Authorize' button and enter your credentials
Test all the APIs

Performance Comparison

Enable dealers to quickly assess and identify how each listing in their inventory is performing against similar vehicles on metrics such as Impressions (Search Result Page appearances), Views (Vehicle Information Page views), and Parkings/Leads (calls + emails). This empowers dealers to take the right actions that will help increase their listing’s performance.

Performance Labels

The following table explains how the calculated performance score is interpreted and translated into a corresponding label, describing what each label represents in terms of ad performance.

Label	Description
HIGH	The ad performs exceptionally well compared to similar listings. Indicates top-tier visibility and engagement. Maintain current strategy and learn from this ad’s success.
ABOVE_AVERAGE	The ad performs better than most comparable listings. Continue current practices while monitoring for potential optimization opportunities.
ON_AVERAGE	The ad performs similarly to comparable listings. It is stable but may benefit from moderate adjustments in price, photos, or description to improve further.
BELOW_AVERAGE	The ad underperforms compared to similar listings. Review content quality, pricing, and competitiveness to boost visibility and leads.
LOW	The ad performs significantly below average. Indicates limited visibility and engagement. Immediate action (re-pricing, feature booking, better photos, improved details) is recommended.

Label

Description

HIGH

The ad performs exceptionally well compared to similar listings. Indicates top-tier visibility and engagement. Maintain current strategy and learn from this ad’s success.

ABOVE_AVERAGE

The ad performs better than most comparable listings. Continue current practices while monitoring for potential optimization opportunities.

ON_AVERAGE

The ad performs similarly to comparable listings. It is stable but may benefit from moderate adjustments in price, photos, or description to improve further.

BELOW_AVERAGE

The ad underperforms compared to similar listings. Review content quality, pricing, and competitiveness to boost visibility and leads.

LOW

The ad performs significantly below average. Indicates limited visibility and engagement. Immediate action (re-pricing, feature booking, better photos, improved details) is recommended.

Fetch Single Ad Performance Comparison

Fetch performance comparison for a single ad

Request

Resource Path	Method	Content-Type / Accept header	Response
https://services.mobile.de/insights-api/performance-comparison/sellers/{mobileSellerId}/ads/{mobileAdId}	GET	application/vnd.de.mobile.api+json	AdPerformanceComparison

Resource Path

Method

Content-Type / Accept header

Response

https://services.mobile.de/insights-api/performance-comparison/sellers/{mobileSellerId}/ads/{mobileAdId}

GET

application/vnd.de.mobile.api+json

AdPerformanceComparison

Example request-line and headers

GET /insights-api/performance-comparison/sellers/1/ads/2 HTTP/1.0
Host: services.mobile.de
Accept: application/vnd.de.mobile.api+json

Response

{
  "mobileAdId":"2",
  "performanceComparisons": {
    "impressionComparison" : {
      "label": "ON_AVERAGE"
     },
    "viewComparison" : {
      "label": "ON_AVERAGE"
     },
    "leadAndParkComparison" : {
      "label": "LOW"
     },
    "overallComparison" : {
      "label": "BELOW_AVERAGE"
     }
  }
}

Response Status	Explanation
200 (OK)	Success
404	Provided mobileAdId does not exist.
404	Provided mobileAdId does not have demand data.
403	Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

Response Status

Explanation

200 (OK)

Success

404

Provided mobileAdId does not exist.

404

Provided mobileAdId does not have demand data.

403

Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

Fetch Performance Comparison Bulk Endpoint

Fetch performance comparison in bulk for multiple ads specified in the request

Maximum 200 mobileAdIds per request.

Request

Resource Path	Method	Content-Type / Accept header	Response
https://services.mobile.de/insights-api/performance-comparison/sellers/{mobileSellerId}	GET	application/vnd.de.mobile.api+json	AdsPerformanceComparisons

Resource Path

Method

Content-Type / Accept header

Response

https://services.mobile.de/insights-api/performance-comparison/sellers/{mobileSellerId}

GET

application/vnd.de.mobile.api+json

AdsPerformanceComparisons

Example request-line and headers

GET /insights-api/performance-comparison/sellers/1?mobileAdIds=123,456 HTTP/1.0
Host: services.mobile.de
Accept: application/vnd.de.mobile.api+json

Response

{
   "mobileSellerId": "1",
   "adsPerformanceComparisons" : [
    {
      "mobileAdId":"123",
      "performanceComparisons": {
        "impressionComparison" : {
          "label": "ON_AVERAGE"
         },
        "viewComparison" : {
          "label": "ON_AVERAGE"
         },
        "leadAndParkComparison" : {
          "label": "LOW"
         },
        "overallComparison" : {
          "label": "BELOW_AVERAGE"
         }
      }
    },
    {
      "mobileAdId":"456",
      "performanceComparisons": {
        "impressionComparison" : {
          "label": "ON_AVERAGE"
         },
        "viewComparison" : {
          "label": "ON_AVERAGE"
         },
        "leadAndParkComparison" : {
          "label": "LOW"
         },
        "overallComparison" : {
          "label": "BELOW_AVERAGE"
         }
      }
    }
   ]
}

Response Status	Explanation
200 (OK)	Success
403	Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller
400	mobileAdIds parameter contains more than 200 ids

Response Status

Explanation

200 (OK)

Success

403

Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

400

mobileAdIds parameter contains more than 200 ids

Popular Search Criteria

Highlights which listing attributes the users are interested in and searching for on the platform, for a specific type of car. It provides a list of popular search filters and the extra features such as parking assistant, which users searched for.

This would help dealers by empowering them to add certain missing crucial attributes so they’re able to improve the listing’s perceived value to the customers. It would also help them to understand why potentially their listing is performing in a certain way (because it has or is missing crucial criteria which is highly demanded by users). It also supports the dealer in creating a targeted search profile based on popular search criteria for analysing their Search results list position.

Fetch Single Ad Popular Search Criteria

Fetch Popular Search Criteria for a single ad

Request

Resource Path	Method	Content-Type / Accept header	Response
https://services.mobile.de/insights-api/popular-search-criteria/sellers/{mobileSellerId}/ads/{mobileAdId}	GET	application/vnd.de.mobile.api+json	PopularSearchCriteriaResponse

Resource Path

Method

Content-Type / Accept header

Response

https://services.mobile.de/insights-api/popular-search-criteria/sellers/{mobileSellerId}/ads/{mobileAdId}

GET

application/vnd.de.mobile.api+json

PopularSearchCriteriaResponse

Example request-line and headers

GET /insights-api/popular-search-criteria/sellers/{mobileSellerId}/ads/{mobileAdId} HTTP/1.0
Host: services.mobile.de
Accept: application/vnd.de.mobile.api+json

Response

{
  "make": "KGM",
  "model": "Rexton",
  "fuel": "PETROL",
  "firstRegistrationYearMin": 2021,
  "firstRegistrationYearMax": 2025,
  "condition": "USED",
  "popularSearchCriteria": {
    "coreFilters": [
      {
        "filter": "interior_type",
        "attribute": "interiorType",
        "filterType": "VALUE_STRING",
        "rank": 9,
        "value": "LEATHER"
      },
      {
        "filter": "mileage",
        "attribute": "mileage",
        "filterType": "RANGE",
        "rank": 1,
        "max": 65000,
        "unit": "km"
      },
      {
        "filter": "power",
        "attribute": "power",
        "filterType": "RANGE",
        "rank": 4,
        "min": 110,
        "unit": "kW"
      },
      {
        "filter": "category",
        "attribute": "category",
        "filterType": "VALUE_STRING",
        "rank": 3,
        "value": "OffRoad"
      },
      {
        "filter": "price",
        "attribute": "price",
        "filterType": "RANGE",
        "rank": 5,
        "min": 15000,
        "max": 40000,
        "unit": "EUR"
      },
      {
        "filter": "seat_count",
        "attribute": "seats",
        "filterType": "RANGE",
        "rank": 6,
        "min": 5
      },
      {
        "filter": "emissions_sticker",
        "attribute": "emissionSticker",
        "filterType": "VALUE_STRING",
        "rank": 8,
        "value": "GREEN"
      },
      {
        "filter": "ready_to_drive",
        "attribute": "roadworthy",
        "filterType": "VALUE_BOOLEAN",
        "rank": 7,
        "value": "true"
      },
      {
        "filter": "transmission",
        "attribute": "gearbox",
        "filterType": "VALUE_STRING",
        "rank": 2,
        "value": "AUTOMATIC_GEAR"
      }
    ],
    "featureFilters": [
      {
        "filter": "FRONT_SENSORS",
        "attribute": "parkingAssistants",
        "rank": 1
      },
      {
        "filter": "VENTILATED_SEATS",
        "attribute": "ventilatedSeats",
        "rank": 2
      },
      {
        "filter": "NONSMOKER_VEHICLE",
        "attribute": "nonSmokerVehicle",
        "rank": 3
      },
      {
        "filter": "REAR_SENSORS",
        "attribute": "parkingAssistants",
        "rank": 4
      },
      {
        "filter": "SUNROOF",
        "attribute": "sunroof",
        "rank": 5
      },
      {
        "filter": "FOUR_WHEEL_DRIVE",
        "attribute": "driveType",
        "rank": 6
      },
      {
        "filter": "FULL_SERVICE_HISTORY",
        "attribute": "fullServiceHistory",
        "rank": 7
      },
      {
        "filter": "ANDROID_AUTO",
        "attribute": "androidAuto",
        "rank": 8
      },
      {
        "filter": "AUTOMATIC_RAIN_SENSOR",
        "attribute": "automaticRainSensor",
        "rank": 9
      },
      {
        "filter": "BLUETOOTH",
        "attribute": "bluetooth",
        "rank": 10
      }
    ]
  }
}

Response Status	Explanation
200 (OK)	Success
404	Provided mobileAdId does not exist.
403	Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

Response Status

Explanation

200 (OK)

Success

404

Provided mobileAdId does not exist.

403

Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

Possible Search Criteria

Currently, the API supports the following popular search criteria. Each filter relies on a specific attribute in the ad data model. For complete attribute definitions, see the data format reference here.

Core Filters

All the core filters that are supported in popular search criteria.

Filter	Relies on Attribute in Ad	Filter Type
consumption_combined	consumptions.combined	RANGE
range_electric	equivalentAllElectricRange	RANGE
emission_class	emissionClass	VALUE_STRING
ready_to_drive	roadworthy	VALUE_BOOLEAN
battery	battery	VALUE_STRING
net_weight	weight	RANGE
trailer_load_braked	trailerLoadBraked	RANGE
trailer_load_unbraked	trailerLoadUnbraked	RANGE
transmission	gearbox	VALUE_STRING
climatisation	climatisation	VALUE_STRING
usage_type	usageType	VALUE_STRING
price	price	RANGE
emissions_sticker	emissionSticker	VALUE_STRING
power	power	RANGE
year_of_construction	constructionDate	RANGE
mileage	mileage	RANGE
charging_time	chargingTime	RANGE
charging_time_fast	chargingTimeFast	RANGE
interior_color	interiorColor	VALUE_STRING
interior_type	interiorType	VALUE_STRING
fuel_tank_volume	fuelTankVolume	RANGE
previous_owners	numberOfPreviousOwners	VALUE_STRING
condition	condition	VALUE_STRING
seat_count	seats	RANGE
exterior_color	exteriorColor	VALUE_STRING
max_nose_weight	maxNoseWeight	RANGE
vatable	price.vatRate	VALUE_BOOLEAN
door_count	doors	VALUE_STRING
cubic_capacity	cubicCapacity	RANGE
cylinder	cylinder	RANGE
battery_capacity	batteryCapacity	RANGE
category	category	VALUE_STRING
airbag	airbag	VALUE_STRING
days_online	creationDate	VALUE_STRING

Filter

Relies on Attribute in Ad

Filter Type

consumption_combined

consumptions.combined

RANGE

range_electric

equivalentAllElectricRange

RANGE

emission_class

emissionClass

VALUE_STRING

ready_to_drive

roadworthy

VALUE_BOOLEAN

battery

VALUE_STRING

net_weight

weight

RANGE

trailer_load_braked

trailerLoadBraked

RANGE

trailer_load_unbraked

trailerLoadUnbraked

RANGE

transmission

gearbox

VALUE_STRING

climatisation

VALUE_STRING

usage_type

usageType

VALUE_STRING

price

RANGE

emissions_sticker

emissionSticker

VALUE_STRING

power

RANGE

year_of_construction

constructionDate

RANGE

mileage

RANGE

charging_time

chargingTime

RANGE

charging_time_fast

chargingTimeFast

RANGE

interior_color

interiorColor

VALUE_STRING

interior_type

interiorType

VALUE_STRING

fuel_tank_volume

fuelTankVolume

RANGE

previous_owners

numberOfPreviousOwners

VALUE_STRING

condition

VALUE_STRING

seat_count

seats

RANGE

exterior_color

exteriorColor

VALUE_STRING

max_nose_weight

maxNoseWeight

RANGE

vatable

price.vatRate

VALUE_BOOLEAN

door_count

doors

VALUE_STRING

cubic_capacity

cubicCapacity

RANGE

cylinder

RANGE

battery_capacity

batteryCapacity

RANGE

Feature Filters

All the feature filters that are supported in popular search criteria.

All feature filters are of type VALUE_BOOLEAN.

Filter	Relies on Attribute in Ad
ROOF_RAILS	roofRails
SPEED_LIMITER	speedLimiter
REPAIR_KIT	breakdownService
FRONT	driveType
HIGH_BEAM_ASSIST	highBeamAssist
AIR_SUSPENSION	airSuspension
KEYLESS_ENTRY	keylessEntry
ELECTRIC_HEATED_REAR_SEATS	electricHeatedSeats
PICTURES	images
DIMMING_INTERIOR_MIRROR	dimmingInteriorMirror
TRAILER_COUPLING_FIX	trailerCouplingType
AUTOMATIC_PARKING	parkingAssistants
DIGITAL_COCKPIT	digitalCockpit
NIGHT_VISION_ASSIST	nightVisionAssist
CAM_360_DEGREES	parkingAssistants
SPARE_WHEEL	breakdownService
VENTILATED_SEATS	ventilatedSeats
RIGHT_HAND_DRIVE	rightHandDrive
ANDROID_AUTO	androidAuto
SUNROOF	sunroof
PRICE_REDUCED	bookableFeatures.redPencil.active
HEAD_UP_DISPLAY	headUpDisplay
SOUND_SYSTEM	soundSystem
FRONT_SENSORS	parkingAssistants
HEATED_STEERING_WHEEL	heatedSteeringWheel
TRAFFIC_SIGN_RECOGNITION	trafficSignRecognition
WIRELESS_CHARGING	wirelessCharging
FOUR_WHEEL_DRIVE	driveType
MASSAGE_SEATS	massageSeats
DYNAMIC_CHASSIS_CONTROL	dynamicChassisControl
FOLDING_ROOF	foldingRoof
LEATHER_STEERING_WHEEL	leatherSteeringWheel
ISOFIX	isofix
TAXI	taxi
ELECTRIC_ADJUSTABLE_SEATS	electricAdjustableSeats
STEEL_WHEELS	steelWheels
ALLOY_WHEELS	alloyWheels
CARPLAY	carplay
TRAILER_COUPLING_DETACHABLE	trailerCouplingType
ARM_REST	armRest
PANORAMIC_GLASS_ROOF	panoramicGlassRoof
COLLISION_AVOIDANCE	collisionAvoidance
EMERGENCY_CALL_SYSTEM	emergencyCallSystem
HEADLIGHT_WASHER_SYSTEM	headlightWasherSystem
WINTER_TIRES	winterTires
FRONT_FOG_LIGHTS	frontFogLights
SKI_BAG	skiBag
ELECTRIC_HEATED_SEATS	electricHeatedSeats
ABS	abs
LIGHT_SENSOR	lightSensor
CARGO_BARRIER	cargoBarrier
LASER_HEADLIGHTS	headlightType
CRUISE_CONTROL	speedControl
SMOKERS_PACKAGE	smokersPackage
DISTANCE_WARNING_SYSTEM	distanceWarningSystem
POWER_ASSISTED_STEERING	powerAssistedSteering
VIRTUAL_SIDE_MIRROR	virtualSideMirror
FOLDING_EXTERIOR_MIRRORS	foldingExteriorMirrors
HILL_START_ASSIST	hillStartAssist
ESP	esp
USB	usb
ALL_WHEEL	driveType
PASSENGER_SEAT_ISOFIX_POINT	passengerSeatIsofixPoint
MEMORY_SEATS	memorySeats
XENON_HEADLIGHTS	headlightType
WINTER_PACKAGE	winterPackage
WARRANTY	warranty
ELECTRIC_BACKSEAT_ADJUSTMENT	electricBackseatAdjustment
REAR	driveType
TV	tv
CD_PLAYER	cdPlayer
VIDEO	videoUrl
BLIND_SPOT_MONITOR	blindSpotMonitor
REAR_VIEW_CAM	parkingAssistants
TRACTION_CONTROL_SYSTEM	tractionControlSystem
TIRE_PRESSURE_MONITORING	tirePressureMonitoring
NEW_SERVICE	newService
AUTOMATIC_RAIN_SENSOR	automaticRainSensor
WIFI_HOTSPOT	wifiHotspot
PADDLE_SHIFTERS	paddleShifters
AMBIENT_LIGHTING	ambientLighting
ELECTRIC_EXTERIOR_MIRRORS	electricExteriorMirrors
ALARM_SYSTEM	alarmSystem
TUNER	radio
FATIGUE_WARNING_SYSTEM	fatigueWarningSystem
FULL_SERVICE_HISTORY	fullServiceHistory
NONSMOKER_VEHICLE	nonSmokerVehicle
ADAPTIVE_BENDING_LIGHTS	bendingLightsType
DAYTIME_RUNNING_LIGHTS	daytimeRunningLamps
LED_HEADLIGHTS	headlightType
LED_RUNNING_LIGHTS	daytimeRunningLamps
ALL_SEASON_TIRES	allSeasonTires
HANDS_FREE_PHONE_SYSTEM	handsFreePhoneSystem
LANE_DEPARTURE_WARNING	laneDepartureWarning
GLARE_FREE_HIGH_BEAM	glareFreeHighBeam
NAVIGATION_SYSTEM	navigationSystem
REAR_SENSORS	parkingAssistants
ELECTRIC_TAILGATE	electricTailgate
FOLD_FLAT_PASSENGER_SEAT	foldFlatPassengerSeat
EMERGENCY_WHEEL	breakdownService
HEATED_WINDSHIELD	heatedWindshield
AUXILIARY_HEATING	auxiliaryHeating
ON_BOARD_COMPUTER	onBoardComputer
TRAILER_COUPLING_SWIVELING	trailerCouplingType
BENDING_LIGHTS	bendingLightsType
REAR_TRAFFIC_ALERT	rearTrafficAlert
MULTIFUNCTIONAL_WHEEL	multifunctionalWheel
SUMMER_TIRES	summerTires
VOICE_CONTROL	voiceControl
ADAPTIVE_CRUISE_CONTROL	speedControl
TOUCHSCREEN	touchscreen
CENTRAL_LOCKING	centralLocking
IMMOBILIZER	immobilizer
LUMBAR_SUPPORT	lumbarSupport
PERFORMANCE_HANDLING_SYSTEM	performanceHandlingSystem
BI_XENON_HEADLIGHTS	headlightType
TINTED_WINDOWS	tintedWindows
DAB_RADIO	radio
SPORT_SEATS	sportSeats
ELECTRIC_WINDOWS	electricWindows
SPORT_PACKAGE	sportPackage
DISABLED_ACCESSIBLE	disabledAccessible
START_STOP_SYSTEM	startStopSystem
BLUETOOTH	bluetooth
INTEGRATED_MUSIC_STREAMING	integratedMusicStreaming

Filter

Relies on Attribute in Ad

ROOF_RAILS

roofRails

SPEED_LIMITER

speedLimiter

REPAIR_KIT

breakdownService

FRONT

driveType

HIGH_BEAM_ASSIST

highBeamAssist

AIR_SUSPENSION

airSuspension

KEYLESS_ENTRY

keylessEntry

ELECTRIC_HEATED_REAR_SEATS

electricHeatedSeats

PICTURES

images

DIMMING_INTERIOR_MIRROR

dimmingInteriorMirror

TRAILER_COUPLING_FIX

trailerCouplingType

AUTOMATIC_PARKING

parkingAssistants

DIGITAL_COCKPIT

digitalCockpit

NIGHT_VISION_ASSIST

nightVisionAssist

CAM_360_DEGREES

parkingAssistants

SPARE_WHEEL

breakdownService

VENTILATED_SEATS

ventilatedSeats

RIGHT_HAND_DRIVE

rightHandDrive

ANDROID_AUTO

androidAuto

SUNROOF

sunroof

PRICE_REDUCED

bookableFeatures.redPencil.active

HEAD_UP_DISPLAY

headUpDisplay

SOUND_SYSTEM

soundSystem

FRONT_SENSORS

parkingAssistants

HEATED_STEERING_WHEEL

heatedSteeringWheel

TRAFFIC_SIGN_RECOGNITION

trafficSignRecognition

WIRELESS_CHARGING

wirelessCharging

FOUR_WHEEL_DRIVE

driveType

MASSAGE_SEATS

massageSeats

DYNAMIC_CHASSIS_CONTROL

dynamicChassisControl

FOLDING_ROOF

foldingRoof

LEATHER_STEERING_WHEEL

leatherSteeringWheel

ISOFIX

isofix

TAXI

taxi

ELECTRIC_ADJUSTABLE_SEATS

electricAdjustableSeats

STEEL_WHEELS

steelWheels

ALLOY_WHEELS

alloyWheels

CARPLAY

carplay

TRAILER_COUPLING_DETACHABLE

trailerCouplingType

ARM_REST

armRest

PANORAMIC_GLASS_ROOF

panoramicGlassRoof

COLLISION_AVOIDANCE

collisionAvoidance

EMERGENCY_CALL_SYSTEM

emergencyCallSystem

HEADLIGHT_WASHER_SYSTEM

headlightWasherSystem

WINTER_TIRES

winterTires

FRONT_FOG_LIGHTS

frontFogLights

SKI_BAG

skiBag

ELECTRIC_HEATED_SEATS

electricHeatedSeats

ABS

abs

LIGHT_SENSOR

lightSensor

CARGO_BARRIER

cargoBarrier

LASER_HEADLIGHTS

headlightType

CRUISE_CONTROL

speedControl

SMOKERS_PACKAGE

smokersPackage

DISTANCE_WARNING_SYSTEM

distanceWarningSystem

POWER_ASSISTED_STEERING

powerAssistedSteering

VIRTUAL_SIDE_MIRROR

virtualSideMirror

FOLDING_EXTERIOR_MIRRORS

foldingExteriorMirrors

HILL_START_ASSIST

hillStartAssist

ESP

esp

USB

usb

ALL_WHEEL

driveType

PASSENGER_SEAT_ISOFIX_POINT

passengerSeatIsofixPoint

MEMORY_SEATS

memorySeats

XENON_HEADLIGHTS

headlightType

WINTER_PACKAGE

winterPackage

WARRANTY

warranty

ELECTRIC_BACKSEAT_ADJUSTMENT

electricBackseatAdjustment

REAR

driveType

CD_PLAYER

cdPlayer

VIDEO

videoUrl

BLIND_SPOT_MONITOR

blindSpotMonitor

REAR_VIEW_CAM

parkingAssistants

TRACTION_CONTROL_SYSTEM

tractionControlSystem

TIRE_PRESSURE_MONITORING

tirePressureMonitoring

NEW_SERVICE

newService

AUTOMATIC_RAIN_SENSOR

automaticRainSensor

WIFI_HOTSPOT

wifiHotspot

PADDLE_SHIFTERS

paddleShifters

AMBIENT_LIGHTING

ambientLighting

ELECTRIC_EXTERIOR_MIRRORS

electricExteriorMirrors

ALARM_SYSTEM

alarmSystem

TUNER

radio

FATIGUE_WARNING_SYSTEM

fatigueWarningSystem

FULL_SERVICE_HISTORY

fullServiceHistory

NONSMOKER_VEHICLE

nonSmokerVehicle

ADAPTIVE_BENDING_LIGHTS

bendingLightsType

DAYTIME_RUNNING_LIGHTS

daytimeRunningLamps

LED_HEADLIGHTS

headlightType

LED_RUNNING_LIGHTS

daytimeRunningLamps

ALL_SEASON_TIRES

allSeasonTires

HANDS_FREE_PHONE_SYSTEM

handsFreePhoneSystem

LANE_DEPARTURE_WARNING

laneDepartureWarning

GLARE_FREE_HIGH_BEAM

glareFreeHighBeam

NAVIGATION_SYSTEM

navigationSystem

REAR_SENSORS

parkingAssistants

ELECTRIC_TAILGATE

electricTailgate

FOLD_FLAT_PASSENGER_SEAT

foldFlatPassengerSeat

EMERGENCY_WHEEL

breakdownService

HEATED_WINDSHIELD

heatedWindshield

AUXILIARY_HEATING

auxiliaryHeating

ON_BOARD_COMPUTER

onBoardComputer

TRAILER_COUPLING_SWIVELING

trailerCouplingType

BENDING_LIGHTS

bendingLightsType

REAR_TRAFFIC_ALERT

rearTrafficAlert

MULTIFUNCTIONAL_WHEEL

multifunctionalWheel

SUMMER_TIRES

summerTires

VOICE_CONTROL

voiceControl

ADAPTIVE_CRUISE_CONTROL

speedControl

TOUCHSCREEN

touchscreen

CENTRAL_LOCKING

centralLocking

IMMOBILIZER

immobilizer

LUMBAR_SUPPORT

lumbarSupport

PERFORMANCE_HANDLING_SYSTEM

performanceHandlingSystem

BI_XENON_HEADLIGHTS

headlightType

TINTED_WINDOWS

tintedWindows

DAB_RADIO

radio

SPORT_SEATS

sportSeats

ELECTRIC_WINDOWS

electricWindows

SPORT_PACKAGE

sportPackage

DISABLED_ACCESSIBLE

disabledAccessible

START_STOP_SYSTEM

startStopSystem

BLUETOOTH

bluetooth

INTEGRATED_MUSIC_STREAMING

integratedMusicStreaming

Sales Probability

The sales probability tells you how likely it is that your vehicle will be sold within the first 60 days of being on the lot. It analyses the comparable vehicles which were recently removed from the platform to calculate a selling probability. This information helps you to take early action in line with your sales strategy per vehicle and proactively reduce stock days, if needed. Using this information, you can plan your sales and marketing efforts more effectively.

Sales Probability Labels

The following table explains the meaning of each salesProbabilityLabel value returned by the API:

Label	Description
NO_RATING	Indicates that no valid probability could be calculated. This occurs when the probability value is missing, invalid, or outside the expected range.
LOW	Indicates a low probability of sale within the first 60 days. The vehicle is unlikely to sell soon and may require price adjustments or additional promotion.
MEDIUM	Indicates a moderate probability of sale. The vehicle has an average chance to be sold within 60 days; monitor performance and consider optimization if it remains too long in stock.
HIGH	Indicates a high probability of sale within the first 60 days. The vehicle is well-positioned and expected to sell quickly.

Label

Description

NO_RATING

Indicates that no valid probability could be calculated. This occurs when the probability value is missing, invalid, or outside the expected range.

LOW

Indicates a low probability of sale within the first 60 days. The vehicle is unlikely to sell soon and may require price adjustments or additional promotion.

MEDIUM

Indicates a moderate probability of sale. The vehicle has an average chance to be sold within 60 days; monitor performance and consider optimization if it remains too long in stock.

HIGH

Indicates a high probability of sale within the first 60 days. The vehicle is well-positioned and expected to sell quickly.

Fetch Single Ad Sales Probability

Fetch sales probability for a single ad

Request

Resource Path	Method	Content-Type / Accept header	Response
https://services.mobile.de/insights-api/sales-probability/sellers/{mobileSellerId}/ads/{mobileAdId}	GET	application/vnd.de.mobile.api+json	AdSalesProbability

Resource Path

Method

Content-Type / Accept header

Response

https://services.mobile.de/insights-api/sales-probability/sellers/{mobileSellerId}/ads/{mobileAdId}

GET

application/vnd.de.mobile.api+json

AdSalesProbability

Example request-line and headers

GET /insights-api/sales-probability/sellers/1/ads/2 HTTP/1.0
Host: services.mobile.de
Accept: application/vnd.de.mobile.api+json

Response

{
  "mobileAdId": "2",
  "salesProbabilityLabel": "LOW"
}

Response Status	Explanation
200 (OK)	Success
404	Provided mobileAdId does not exist.
403	Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

Response Status

Explanation

200 (OK)

Success

404

Provided mobileAdId does not exist.

403

Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

Fetch Sales Probability Bulk Endpoint

Fetch sales probability in bulk for multiple ads specified in the request

Maximum 200 mobileAdIds per request.

Request

Resource Path	Method	Content-Type / Accept header	Response
https://services.mobile.de/insights-api/sales-probability/sellers/{mobileSellerId}	GET	application/vnd.de.mobile.api+json	AdsSalesProbabilities

Resource Path

Method

Content-Type / Accept header

Response

https://services.mobile.de/insights-api/sales-probability/sellers/{mobileSellerId}

GET

application/vnd.de.mobile.api+json

AdsSalesProbabilities

Example request-line and headers

GET /insights-api/sales-probability/sellers/1?mobileAdIds=123,456 HTTP/1.0
Host: services.mobile.de
Accept: application/vnd.de.mobile.api+json

Response

{
  "mobileSellerId": "1",
  "adSalesProbabilityList": [
    {
      "mobileAdId": "123",
      "salesProbabilityLabel": "MEDIUM"
    },
    {
      "mobileAdId": "456",
      "salesProbabilityLabel": "HIGH"
    }
  ]
}

Response Status	Explanation
200 (OK)	Success
403	Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller
400	mobileAdIds parameter contains more than 200 ids

Response Status

Explanation

200 (OK)

Success

403

Not Allowed to access this ad, e.g. because the ad is not owned by the allowed seller

400

mobileAdIds parameter contains more than 200 ids

References

Resources Reference

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

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

https://services.mobile.de

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

Name Method Endpoint Query Parameters

Name	Method	Endpoint	Query Parameters
Fetch Single Ad Performance Comparison	`GET`	`/insights-api/performance-comparison/sellers/1/ads/2`	NA
Fetch Performance Comparison Bulk Endpoint	`GET`	`/insights-api/performance-comparison/sellers/1`	mobileAdIds, fetch specific ads performance comparison, e.g. `mobileAdIds=1,2,3`, maximum 200 ids per request
Fetch Single Ad Popular Search Criteria	`GET`	`/insights-api/popular-search-criteria/sellers/1/ads/2`	NA
Fetch Single Ad Sales Probability	`GET`	`/insights-api/sales-probability/sellers/1/ads/2`	NA
Fetch Sales Probability Bulk Endpoint	`GET`	`/insights-api/sales-probability/sellers/1`	mobileAdIds, fetch specific ads sales probability, e.g. `mobileAdIds=1,2,3`, maximum 200 ids per request

Fetch Single Ad Performance Comparison

GET

/insights-api/performance-comparison/sellers/1/ads/2

Fetch Performance Comparison Bulk Endpoint

GET

/insights-api/performance-comparison/sellers/1

mobileAdIds, fetch specific ads performance comparison, e.g. mobileAdIds=1,2,3, maximum 200 ids per request

Fetch Single Ad Popular Search Criteria

GET

/insights-api/popular-search-criteria/sellers/1/ads/2

Fetch Single Ad Sales Probability

GET

/insights-api/sales-probability/sellers/1/ads/2

Fetch Sales Probability Bulk Endpoint

GET

/insights-api/sales-probability/sellers/1

mobileAdIds, fetch specific ads sales probability, e.g. mobileAdIds=1,2,3, maximum 200 ids per request

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 Insights 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.

Data Format

AdsPerformanceComparisons

Top level type for representing performance comparison data.

Field Name	Type	Description
ADS PERFORMANCE COMPARISONS
mobileSellerId	String	mobile-platform Seller ID
adsPerformanceComparisons	Collection of AdPerformanceComparison	List of AdPerformanceComparison

Field Name

Type

Description

ADS PERFORMANCE COMPARISONS

mobileSellerId

String

mobile-platform Seller ID

adsPerformanceComparisons

Collection of AdPerformanceComparison

List of AdPerformanceComparison

AdPerformanceComparison

Top level type for representing ad performance comparison data.

Field Name	Type	Description
AD PERFORMANCE COMPARISON
mobileAdId	String	mobile-platform Ad ID
performanceComparisons	PerformanceComparisons	performance comparison for different metrics
noRatingReason	NoRatingReason	This field is only present when there are NO_RATING labels for the comparisons, providing details on why no rating is available.

Field Name

Type

Description

AD PERFORMANCE COMPARISON

mobileAdId

String

mobile-platform Ad ID

performanceComparisons

PerformanceComparisons

performance comparison for different metrics

noRatingReason

NoRatingReason

This field is only present when there are NO_RATING labels for the comparisons, providing details on why no rating is available.

PerformanceComparisons

Top level type for representing performance comparison data.

Field Name	Type	Description
PERFORMANCE COMPARISONS
impressionComparison	PerformanceComparison	Search Impressions performance comparison
viewComparison	PerformanceComparison	Ad detail views performance comparison
leadAndParkComparison	PerformanceComparison	Calls, Emails and Parking performance comparison
overallComparison	PerformanceComparison	Overall performance comparison

Field Name

Type

Description

PERFORMANCE COMPARISONS

impressionComparison

PerformanceComparison

Search Impressions performance comparison

viewComparison

PerformanceComparison

Ad detail views performance comparison

leadAndParkComparison

PerformanceComparison

Calls, Emails and Parking performance comparison

overallComparison

PerformanceComparison

Overall performance comparison

PerformanceComparison

Top level type for representing performance comparison data.

Field Name	Type	Description
PERFORMANCE COMPARISON
label	String	performance comparison label for the metric, Possible values NO_RATING, LOW, BELOW_AVERAGE, ON_AVERAGE, ABOVE_AVERAGE, HIGH

Field Name

Type

Description

PERFORMANCE COMPARISON

label

String

performance comparison label for the metric, Possible values NO_RATING, LOW, BELOW_AVERAGE, ON_AVERAGE, ABOVE_AVERAGE, HIGH

PopularSearchCriteriaResponse

Top level type for representing popular search criteria data.

Field Name	Type	Description
POPULAR SEARCH CRITERIA RESPONSE
make	String	make key that has been used for this lookup see https://services.mobile.de/refdata/classes/Car/makes
model	String	model key that has been used for this lookup see https://services.mobile.de/refdata/classes/Car/makes/AUDI/models
fuel	String	fuel type key that has been used for this lookup see https://services.mobile.de/refdata/fuels
firstRegistrationYearMin	Integer	lower boundary of the year of the first registration date of the vehicle that has been used for this lookup
firstRegistrationYearMax	Integer	upper boundary of the year of the first registration date of the vehicle that has been used for this lookup
condition	String	condition of the vehicle, can be either NEW or USED
popularSearchCriteria	PopularSearchCriteria	PopularSearchCriteria

Field Name

Type

Description

POPULAR SEARCH CRITERIA RESPONSE

make

String

make key that has been used for this lookup see https://services.mobile.de/refdata/classes/Car/makes

model

String

model key that has been used for this lookup see https://services.mobile.de/refdata/classes/Car/makes/AUDI/models

fuel

String

fuel type key that has been used for this lookup see https://services.mobile.de/refdata/fuels

firstRegistrationYearMin

Integer

lower boundary of the year of the first registration date of the vehicle that has been used for this lookup

firstRegistrationYearMax

Integer

upper boundary of the year of the first registration date of the vehicle that has been used for this lookup

condition

String

condition of the vehicle, can be either NEW or USED

popularSearchCriteria

PopularSearchCriteria

Type representing the popular search criteria.

Field Name	Type	Description
popular search criteria
coreFilters	Collection of CoreFilter	List of CoreFilter
featureFilters	Collection of FeatureFilter	List of FeatureFilter

Field Name

Type

Description

popular search criteria

coreFilters

Collection of CoreFilter

List of CoreFilter

featureFilters

Collection of FeatureFilter

List of FeatureFilter

CoreFilter

Type representing a core filter popular search criteria.

Field Name	Type	Description
CORE FILTER
filter	String	filter name
attribute	String	attribute within the ad object
filterType	String	type of filter, Possible values RANGE, VALUE_STRING, VALUE_BOOLEAN
rank	Integer	indicates the rank popularity within the core filter ( the lower the more popular )
min	Integer	minimum value for filters of type RANGE
max	Integer	maximum value for filters of type RANGE
value	String	minimum value for filters of type VALUE_STRING
unit	String	unit for filters in case there is one

Field Name

Type

Description

CORE FILTER

filter

String

filter name

attribute

String

attribute within the ad object

filterType

String

type of filter, Possible values RANGE, VALUE_STRING, VALUE_BOOLEAN

rank

Integer

indicates the rank popularity within the core filter ( the lower the more popular )

min

Integer

minimum value for filters of type RANGE

max

Integer

maximum value for filters of type RANGE

value

String

minimum value for filters of type VALUE_STRING

unit

String

unit for filters in case there is one

FeatureFilter

Type representing a feature filter popular search criteria.

Field Name	Type	Description
FEATURE FILTER
filter	String	filter name
attribute	String	attribute within the ad object
rank	Integer	indicates the rank popularity within the feature filter ( the lower the more popular )

Field Name

Type

Description

FEATURE FILTER

filter

String

filter name

attribute

String

attribute within the ad object

rank

Integer

indicates the rank popularity within the feature filter ( the lower the more popular )

ErrorResponse

Top level type that describes api call failure

Field Name	Type	Description
errorCode	ERROR_CODE	Specific error code indicating the type of error.
message	String	Human readable error description

Field Name

Type

Description

errorCode

ERROR_CODE

Specific error code indicating the type of error.

message

String

Human readable error description

AdsSalesProbabilities

Top level type for representing sales probability data.

Field Name	Type	Description
ADS SALES PROBABILITIES
mobileSellerId	String	mobile-platform Seller ID
adsSalesProbabilities	Collection of AdSalesProbability	List of AdSalesProbability

Field Name

Type

Description

ADS SALES PROBABILITIES

mobileSellerId

String

mobile-platform Seller ID

adsSalesProbabilities

Collection of AdSalesProbability

List of AdSalesProbability

AdSalesProbability

Top level type for representing ad sales probability data.

Field Name	Type	Description
AD SALES PROBABILITY
mobileAdId	String	mobile-platform Ad ID
salesProbabilityLabel	String	sales probability label for the metric, Possible values LOW, MEDIUM, HIGH, NO_RATING

Field Name

Type

Description

AD SALES PROBABILITY

mobileAdId

String

mobile-platform Ad ID

salesProbabilityLabel

String

sales probability label for the metric, Possible values LOW, MEDIUM, HIGH, NO_RATING

NoRatingReason

Possible Value	Description
TOO_FEW_COMPETITORS	There were too few competitors to generate performance comparison.
TOO_FEW_SIMILAR_ADS	There were too few similar ads to generate a performance comparison.
DEMAND_NOT_FOUND	There was not enough demand to generate a performance comparison.
PERFORMANCE_RATING_NOT_FOUND	Performance comparison currently not available, try in next 24 hours.

Possible Value

Description

TOO_FEW_COMPETITORS

There were too few competitors to generate performance comparison.

TOO_FEW_SIMILAR_ADS

There were too few similar ads to generate a performance comparison.

DEMAND_NOT_FOUND

There was not enough demand to generate a performance comparison.

PERFORMANCE_RATING_NOT_FOUND

Performance comparison currently not available, try in next 24 hours.

ERROR_CODE

Possible Value	Description
INTERNAL_ERROR	An internal error occurred. Please try again later.
FORBIDDEN	You do not have permission to access this resource.
BAD_REQUEST	The request is invalid. Please check the request parameters and try again.

Possible Value

Description

INTERNAL_ERROR

An internal error occurred. Please try again later.

FORBIDDEN

You do not have permission to access this resource.

BAD_REQUEST

The request is invalid. Please check the request parameters and try again.

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

Country

Contact Details

Germany

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