mobileLogo

Seller API description

Introduction

The mobile.de Seller-API is an interface to store seller vehicle and user data to the mobile.de-database and make them available on the platform as classified ads. It enables API partners to carry out all necessary operations to manage the full lifecycle of listings from creation to deletion.

Sandbox

For testing purposes a sandbox is available at this base URL:
https://services.mobile.de/ using a proxy server.

This sandbox offers the full functionality of the seller API as described in this document. Furthermore you can verify your results by retrieving the XML data of the ads from the seller API itself or by logging into the dealer area of the assigned sandbox account. Please contact Customer Service for Sandbox access.

Technical basics

The API is available at this base URL:
https://services.mobile.de/

In general the API follows the conventions for REST-APIs. All communication is done via HTTP, the correct combination of request methods and URL trigger the actions of the API.
You can find more information about the REST principle here:http://en.wikipedia.org/wiki/Representational_State_Transfer

API user / TSP

An "API user" is the entity that has an "API account" and uses that account to post ads for one or more sellers (which are linked to that account) to the API. Usually the "API user" is a TSP ("Transfer Service Provider") which posts ads for a larger number of sellers.

Sites / site-id / site-key

mobile.de runs different websites in different countries. For example www.mobile.dein Germany and www.automobile.it in Italy. Each of those sites is identified by asite-key.
You can find a full list of the site-keys in our reference data.

However this API is for all of those sites but for the various sites there may exist some different rules for offering a vehicle and different sets of reference data (make and model sets, vehicle classes and feature sets) might be visible.

Each seller is at home on one of these sites. When posting ads, they are created on the site where the seller is at home and so the specific reference data and validation rules of that site apply to new ads.

This is why you should know on which site your sellers are at home. See Retrieve all your sellers to find out the site-keys of your sellers.

Authorization / permissions

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 Customer Support for further details about this activation process!

There are 3 authentication methods. Each of them requires a valid API user as described above and the only difference between them is a technical aspect how the user credentials are passed to the service.

  1. HTTP Basic Authentication (Recommended)

    The user must be authenticated with a username and password using the HTTP basic authentication scheme.
    For detailed information on HTTP basic authentication seehttp://en.wikipedia.org/wiki/Basic_access_authentication orhttp://tools.ietf.org/html/rfc1945#section-10.2.

    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.

    Note:This authentication method uses the same credentials as the FTP Upload-Interface.
    Please contact customer supportfor details.

  2. Seller API Token (Deprecated)

    This is the method used for the existing users and the tokens won't be issued for the new users. The Seller-API Token is a character string which (as a special HTTP header) has to be included for each API call.

    HTTP header elementDescription
    X-MOBILE-SELLER-TOKENStatic token of the registered API user

    Example auth token HTTP header:
    X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf

    Note:In the near future this method will be phased out in favor of the more secure http basic authentication method - please see the previous point for details.

  3. Username and Password as the Token (Temporary)

    This method has been introduced to make it easier for the API users to migrate from the token authentication to the recommended http basic authentication.

    It uses the same credentials as the http basic authentication but the username and passwordare provided via the X-MOBILE-SELLER-TOKEN header in the following format:

    HTTP header elementDescription
    X-MOBILE-SELLER-TOKENusername:password

    The value of the header is the username and the password separated by the ":" (colon character). The motivation here is to allow the API users switching to the more secure authentication method (username and password) without changing the actual scheme. Switching to this method is as simple as standard procedure of changing the Seller-API Token.

    Example auth token HTTP header:
    X-MOBILE-SELLER-TOKEN: myuser:mypassword

For handling ads for dealer sellers, those sellers need to be linked to your API account.
Please note: The seller-key is not the customer-number.
There is a special API call which gives you a list of all sellers that are linked to your account including their seller-key and customer-number (in case it's a dealer).

Concurrency

Do not send multible requests for the same ad at the same time. Always wait for the request to be finished before sending the next one (in scope of the same ad) or you will run into problems.
E.g. do not update one ad's images while another image-update-call for the same ad is still in progress.

XML format and versioning

XML schema files

The error information that is returned whe you do something wrongerror-1.0.xsd
Some basic data types used by almost all other schemastypes-1.0.xsd
seller data (for retrieving sellers)seller-2.0.xsd
The adseller-ad-1.1.xsd
Price data (included in ads)price-1.0.xsd
Vehicle data (included in ads)vehicle-1.0.xsd
Some country specific properties (included in vehicle)site-specifics-1.0.xsd
Advice

Versioning

To remain backward compatible (when we do major changes to our XML schema), the API is able to handle different schema versions. You have to tell the API which version you send or expect.

This is done by the default HTTP header fields Content-Type and Accept.
The Content-Type (for POST and PUT) or Accept (for GET) header contains a media type (also see http://en.wikipedia.org/wiki/Internet_media_type) and must be explicitly set for each request.

HTTP header elementDescription
Acceptdesired media type for GET
Content-Typemedia type that is sent for POST or PUT

The header value is the media type and each media type refers to an XML schema. This document only refers to the newest an best supported media types and XML schemas. Here is a list of the media types:

Content-Type / Accept header (media type)XML schema
application/vnd.de.mobile.seller-v2.0+xmlhttp://services.mobile.de/schema/common/seller-2.0.xsd
application/vnd.de.mobile.seller-ad-v1.1+xmlhttp://services.mobile.de/schema/seller/seller-ad-1.1.xsd
application/vnd.de.mobile.ad-statistic-v1.0+xmlhttp://services.mobile.de/schema/seller/ad-statistic-1.0.xsd

Reference data

Parts of the XML refer to our reference data. Here you find reference tables for the enumerated fields, like features, colors, makes, models and others.

Validation and error handling

Most errors occur when sending ad data to the API. Sending invalid data results in an HTTP status code 400 (bad request). The validation and error handling for this use case is handled in this section.
For other errors, like authorization and not-found errors see the complete list ofHTTP response status codes.

Validation

The API checks for errors on two different levels:

Parsing and XML validation

On this level the XML parser tries to read the XML data and validate it according to our XML schema. Some examples of issues that cause this validation level to fail:

As the schema is also used for outgoing data (after applying various privacy filters), it is not very strict concerning mandatory elements and attributes.
But there are numerous checks for required data in the next validation level.

Semantic validation

Semantic validation checks for various business rules. Examples:

Please note that semantic validation rules may depend on the seller's site-key.
For example, some rules apply only for ads of sellers with a site-key GERMANY but not forads of a seller with site-key FRANCE.

See Semantic Rules for a list of validation rules.

Error response

Once you have caused a validation error on either level, the API will answer with an HTTP status 400.

To find out what the exact error is, have a look at the returned XML content which is sent in the message body. It contains a list of error elements, each with an error key. There may also be an optional message attribute which is a localized description of the error key.

Example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<errors>
    <error key="vehicle-empty"/>
    <error key="price-empty"/>
    <error key="street-contains-url" message="Das Feld Straße darf keine URL enthalten"/>
</errors>

For a selection of most common error codes see Semantic Rules.

HTTP response status codes

200 (OK)

A successful API call will be indicated by an HTTP-status code 200 (OK).

201 (created)

When you have posted something, a successful API call will be indicated by an HTTP-status code 201 (created). Have a look at the returned HTTP header Location.
It contains the URL of the newly created resource and you should memorize at least the id or key of that item, which you can find at the end of the URL.

HTTP header elementDescription
LocationURL of newly created resource

Example of a newly created ad with the ad-key 456:
Location: https://services.mobile.de/seller-api/sellers/123/ads/456

204 (No Content)

After deleting something (HTTP method DELETE) a successful API call will be indicated by an HTTP-status code 204 (No Content), though that resource no longer exists.

400 (bad request)

This code is returned when there is something wrong with the content that you have sent. See sectionValidation and error handling.

401 (unauthorized)

This code is returned on a wrong/missing token for authentication.

Example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<errors>
    <error key="wrong-token"/>
</errors>

If you keep getting authorization errors check the following list of possible error causes:

404 (not found)

This status code is returned when you are trying to access a resource that does not exist. In a simple case this can be a typo in the path you are accessing, but this can also have another reason:

From your point of view, only sellers that are linked to your API account are visible. So if you try to read or write data for a seller that is not linked to your account and therefore not existing in your API universe, you will get an HTTP status code 404.

Example:
The seller with the key 123 is linked to your account, the seller with the key 456 is not. Posting an ad to /seller-api/sellers/123/ads results in an HTTP status 201 (created) whereas posting an ad to /seller-api/sellers/456/ads results in an HTTP status 404 (not found).

If you keep getting not found errors, check the following list of possible error causes:

5xx

If you receive an HTTP code starting with 5 then we did something wrong. Please contact customer support and report the error.

Resources

Please refer to the following table for an overview of the methods and corresponding calls.

Use CaseResource pathMethodContent-Type / Accept header
Retrieve all your sellers/seller-api/sellersGETapplication/vnd.de.mobile.seller-v2.0+xml
Retrieve seller/seller-api/sellers/{seller-key}GETapplication/vnd.de.mobile.seller-v2.0+xml
Create ad/seller-api/sellers/{seller-key}/adsPOSTapplication/vnd.de.mobile.seller-ad-v1.1+xml
Retrieve all ads of a seller/seller-api/sellers/{seller-key}/adsGETapplication/vnd.de.mobile.seller-ad-v1.1+xml
Retrieve ad/seller-api/sellers/{seller-key}/ads/{adId}GETapplication/vnd.de.mobile.seller-ad-v1.1+xml
Update ad/seller-api/sellers/{seller-key}/ads/{adId}PUTapplication/vnd.de.mobile.seller-ad-v1.1+xml
Renew ad/seller-api/sellers/{seller-key}/ads/{adId}/vehicle-attribute/renewal-datePOSTapplication/vnd.de.mobile.seller-ad-v1.1+xml
Delete ad/seller-api/sellers/{seller-key}/ads/{adId}DELETENone
Upload images/seller-api/sellers/{seller-key}/ads/{adId}/imagesPUTmultipart/form-data / application/vnd.de.mobile.seller-ad-v1.1+xml
Get all image URLs/seller-api/sellers/{seller-key}/ads/{adId}/imagesGETapplication/vnd.de.mobile.seller-ad-v1.1+xml
Delete all images/seller-api/sellers/{seller-key}/ads/{adId}/imagesDELETENone

{seller-key} is to be replaced by the seller-key (which is not the customer-number - seeRetrieve all your sellers for a translation method) and{adId} is to be replaced by the ID of the ad.

Retrieve all your sellers

With this call you can get a list of all sellers that are linked to your API account. These are all dealer sellersthat were linked to your account.
The dealer sellers also include their customer-number, this is very useful in case you want to translatecustomer-numbers into seller-keys.

The site-ID is included as well - which is important to know, due to the fact that some validation rules depend on thesite.

Not all fields of the XML will be retrievable, it depends on what you are allowed (permissions) to see.

The result contains also the maximum number of images the seller is allowed to upload per each ad. Please note that this number may vary for different sellers and could change over the time.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellersGETapplication/vnd.de.mobile.seller-v2.0+xml
Example request-line and headers
GET /seller-api/sellers HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Accept: application/vnd.de.mobile.seller-v2.0+xml

Response

Response statusExplanation
200 (OK)success
Example status-line and headers
HTTP/1.1 200 OK
Content-Type: application/vnd.de.mobile.seller-v2.0+xml
Example message-body
<?xml version="1.0" encoding="UTF-8"?>
<sellers
    xmlns="http://services.mobile.de/schema/common/seller-2.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://services.mobile.de/schema/common/seller-2.0.xsd"
>
    <seller customerNumber="86" site-id="GERMANY" type="DEALER" key="1499">
        <location-contact company-name="Example Company 1 GmbH"/>
        <settings>
            <max-images value="30"/>
            <used-car-seals>
                <used-car-seal value="VW"/>
                <used-car-seal value="AUDI"/>
            </used-car-seals>
            <automated-exports>
                <automated-export marketplace="ebay-kleinanzeigen.de" eligible="true" active="false"/>
            </automated-exports>
            <video-url value="true"/>
        </settings>
    </seller>
    <seller customerNumber="96" site-id="FRANCE" type="DEALER" key="1509">
        <location-contact company-name="Example Company 2"/>
        <settings>
            <max-images value="15"/>
            <used-car-seals>
                <used-car-seal value="CITROEN"/>
                <used-car-seal value="RENAULT"/>
            </used-car-seals>
            <automated-exports>
                <automated-export marketplace="ebay-kleinanzeigen.de" eligible="true" active="true"/>
            </automated-exports>
            <video-url value="true"/>
        </settings>
    </seller>
</sellers>

Retrieve a single seller

Not all fields of the XML will be populated, it depends on what you are allowed (permissions) to see.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}GETapplication/vnd.de.mobile.seller-v2.0+xml
Example request-line and headers
GET /seller-api/sellers/123 HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Accept: application/vnd.de.mobile.seller-v2.0+xml

Response

Response statusExplanation
200 (OK)success
404 (not found)You provided a wrong seller-key.

Create ad

Please note: you should store the returned ad-key in order to be able to revise the ad, add images to it or delete it later.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/adsPOSTapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
POST /seller-api/sellers/123/ads HTTP/1.0 Host: services.mobile.de X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf Content-Type: application/vnd.de.mobile.seller-ad-v1.1+xml
Example message-body
<?xml version="1.0" encoding="UTF-8"?>
<ad xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://services.mobile.de/schema/seller/seller-ad-1.1"
    xmlns:vehicle="http://services.mobile.de/schema/seller/vehicle-1.0"
    xmlns:site-specifics="http://services.mobile.de/schema/seller/site-specifics-1.0"
    xmlns:price="http://services.mobile.de/schema/seller/price-1.0"
    xsi:schemaLocation="http://services.mobile.de/schema/seller/seller-ad-1.1 http://services.mobile.de/schema/seller/seller-ad-1.1.xsd">
    <seller-inventory-key value="fooBar42"/>
    <description>This is really a nice car. The only strange thing is that so called flux capacitor that it is equipped
    with. The previous owner told me that he took it from an old DeLorean. No idea what it is good for.</description>
    <mobile-features>
        <feature>EYE_CATCHER</feature>
        <feature>PAGE_ONE_AD</feature>
        <feature>TOP_OF_PAGE</feature>
    </mobile-features>
    <vehicle:vehicle>
        <vehicle:classification>
            <vehicle:vehicle-class key="Car"/>
            <vehicle:category key="Cabrio"/>
            <vehicle:make key="PORSCHE"/>
            <vehicle:model key="993"/>
        </vehicle:classification>
        <vehicle:model-description value="993 coupe Carrera 4"/>
        <vehicle:damage-and-unrepaired value="false"/>
        <vehicle:accident-damaged value="false"/>
        <vehicle:roadworthy value="true"/>
        <vehicle:features>
            <vehicle:feature key="ALLOY_WHEELS"/>
            <vehicle:feature key="ELECTRIC_WINDOWS"/>
            <vehicle:feature key="IMMOBILIZER"/>
            <vehicle:feature key="ABS"/>
            <vehicle:feature key="ESP"/>
            <vehicle:feature key="HU_AU_NEU"/>
        </vehicle:features>
        <vehicle:specifics>
            <vehicle:exterior-color key="">
                <vehicle:metallic value="false"/>
                <vehicle:manufacturer-color-name value="Kuntergraudunkelbunt"/>
            </vehicle:exterior-color>
            <vehicle:mileage value="142000"/>
            <vehicle:door-count key="TWO_OR_THREE"/>
            <vehicle:fuel key="PETROL"/>
            <vehicle:power value="210"/>
            <vehicle:gearbox key="MANUAL_GEAR"/>
            <vehicle:construction-date value="1997-04-12"/>
            <vehicle:cubic-capacity value="3600"/>
            <vehicle:condition key="USED"/>
            <vehicle:interior-type key="ALCANTARA"/>
            <vehicle:number-of-previous-owners value="1"/>
            <vehicle:parking-assistants>
                <vehicle:parking-assistant key="FRONT_SENSORS"/>
                <vehicle:parking-assistant key="REAR_SENSORS"/>
            </vehicle:parking-assistants>
        </vehicle:specifics>
        <vehicle:site-specifics>
            <site-specifics:first-registration value="1997-09"/>
            <site-specifics:schwacke-code value="2366642"/>
        </vehicle:site-specifics>
    </vehicle:vehicle>
    <price:price type="FIXED" currency="EUR">
        <price:gross-prices>
            <price:consumer-price-amount value="32000.00"/>
        </price:gross-prices>
    </price:price>
</ad>

Response

The response contains a Location header which leads you to the URL of the newly created ad. You find the newad-key at the end of that URL.

Response statusExplanation
201 (Created)success
400 (bad request)There was something wrong with the content that you provided. Please see the message-body for detailed error information.
404 (not found)You provided a wrong seller-key.
Example status-line and headers
HTTP/1.1 201 Created Location: https://services.mobile.de/seller-api/sellers/123/ads/456

Retrieve all ads of a seller

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/adsGETapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
GET /seller-api/sellers/123/ads HTTP/1.0 Host: services.mobile.de X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf Accept: application/vnd.de.mobile.seller-ad-v1.1+xml

Response

Response statusExplanation
200 (OK)success
404 (not found)You provided a wrong seller-key.

Retrieve a single ad

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{ad-key}GETapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
GET /seller-api/sellers/123/ads/456 HTTP/1.0 Host: services.mobile.de X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf Accept: application/vnd.de.mobile.seller-ad-v1.1+xml

Response

Response statusExplanation
200 (OK)success
404 (not found)You provided a wrong seller-key or a wrong ad-key.

Update ad

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{adId}PUTapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
PUT /seller-api/sellers/123/ads/456 HTTP/1.0 Host: services.mobile.de X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf Content-Type: application/vnd.de.mobile.seller-ad-v1.1+xml
Example message-body
<?xml version="1.0" encoding="UTF-8"?>
<ad ...>
    ...some stuff omitted to make it a shorter example...
</ad>

Response

Response statusExplanation
200 (OK)success
400 (bad request)There was something wrong with the content that you provided. Please see the message-body for detailed error information.
404 (not found)You provided a wrong seller-key or a wrong ad-key.
Example status-line and headers
HTTP/1.1 200 OK

Renew ad

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{ad-key}/vehicle-attribute/renewal-datePOSTapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
POST /seller-api/sellers/123/ads/456/vehicle-attribute/renewal-date HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Content-Type: application/vnd.de.mobile.seller-ad-v1.1+xml

Response

Response statusExplanation
204 (OK)success
400 (bad request)There was something wrong with the content that you provided. Please see the message-body for detailed error information.
404 (not found)You provided a wrong seller-key or a wrong ad-key.
Example status-line and headers
HTTP/1.1 204 OK

Delete ad

Note: it is NOT necessary to delete the images before deleting the ad.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{ad-key}DELETENone
Example request-line and headers
DELETE /seller-api/sellers/123/ads/456 HTTP/1.0 Host: services.mobile.de X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf

Response

Response statusExplanation
200 (OK)success
404 (not found)The ad either has already been deleted or you provided a wrong seller-key or a wrong ad-key.
Example status-line and headers
HTTP/1.1 200 OK

Upload images

The API Images-Handling is done in a way which processes all changes in one call.
mobile.de uses the external ebay picture service to store the images, which results in certain limitations:

The API call to add images supports two modes:

Add pictures initially

All images, which are related to the ad are added to it via the API in one single call.

The content-type of the request entity must be "multipart/form-data". The content type of a single part must be "image/jpeg". The parts are named "image".

The images are attached to the ad in the same order as you put them into the request.

The response will be a list of image URLs. You have to store those URLs as a reference for future image operations an this ad.

Change pictures

After initially putting images to the ad you can also remove single images, change image order or add other images to the ad.

In this case a single part of the request entity contains either an image in the way described above or the internal image url. A part containing an internal image url must be named "image-ref". Please note that external URLs will be rejected!

Just send another multipart request. You only need to provide binary image data for new images. All existing images are referenced by their ebay-picture-service-URLs. In this case the name of the single part is "image-ref". Images that are no longer referenced will be deleted. New images included as binary data will be added. The order in the multipart request becomes the order of the ads images. Have a look at the below example.

Request

Resource pathMethodContent-Type headerAccept header
/seller-api/sellers/{seller-key}/ads/{adId}/imagesPUTmultipart/form-dataapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
PUT /seller-api/sellers/123/ads/456/images HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Content-Type: multipart/form-data; boundary=vjrLeiXjJaWiU0JzZkUPO1rMcE2HQ-n7XsSx
Accept: application/vnd.de.mobile.seller-ad-v1.1+xml
Example message-body

In this example we re-use two existing images and then on the third position add a new image:

--vjrLeiXjJaWiU0JzZkUPO1rMcE2HQ-n7XsSx
Content-Disposition: form-data; name="image-ref"
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 8bit

http://i.ebayimg.sandbox.ebay.com/00/$(KGrHqFHJDcE+cwqiFIiBQK5GYM8rw~~_27.JPG
--vjrLeiXjJaWiU0JzZkUPO1rMcE2HQ-n7XsSx
Content-Disposition: form-data; name="image-ref"
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 8bit

http://i.ebayimg.sandbox.ebay.com/00/$(KGrHqJHJEEE+W42KkNBBQK5GW!RPQ~~_27.JPG
--vjrLeiXjJaWiU0JzZkUPO1rMcE2HQ-n7XsSx
Content-Disposition: form-data; name="image"; filename="image.jpg"
Content-Type: image/jpeg
Content-Transfer-Encoding: binary

 ...some binary JPEG data omitted here...
--vjrLeiXjJaWiU0JzZkUPO1rMcE2HQ-n7XsSx--

Response

Response statusExplanation
200 (OK)success
400 (bad request)There was something wrong with the content that you provided. Please see the message-body for detailed error information.
404 (not found)You provided a wrong seller-key or a wrong ad-key.
Example status-line and headers
HTTP/1.1 200 OK
Content-Type: application/vnd.de.mobile.seller-ad-v1.1+xml
Example message-body
<?xml version='1.0' encoding='UTF-8'?>
<images xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://services.mobile.de/schema/seller/seller-ad-1.1"
    xsi:schemaLocation="http://services.mobile.de/schema/seller/seller-ad-1.1 http://services.mobile.de/schema/seller/seller-ad-1.1.xsd">
    <image ref="http://i.ebayimg.sandbox.ebay.com/00/$(KGrHqFHJDcE+cwqiFIiBQK5GYM8rw~~_27.JPG"/>
    <image ref="http://i.ebayimg.sandbox.ebay.com/00/$(KGrHqJHJEEE+W42KkNBBQK5GW!RPQ~~_27.JPG"/>
    <image ref="http://i.ebayimg.sandbox.ebay.com/00/$(KGrHqZHJCYF!Io-260mBQK5GYrJTw~~_27.JPG" hash="e4abea3cb9fc16ec9e7a707f8927bff2"/>
</images>

Get all image URLs

Use this API call to receive all Image URLs of an ad.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{adId}/imagesGETapplication/vnd.de.mobile.seller-ad-v1.1+xml
Example request-line and headers
GET /seller-api/sellers/123/ads/456/images HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Accept: application/vnd.de.mobile.seller-ad-v1.1+xml

Response

Response statusExplanation
200 (OK)success
404 (not found)You provided a wrong seller-key or a wrong ad-key.

Delete all images

It is NOT required to delete the images before deleting the ad.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{ad-key}/imagesDELETENone
Example request-line and headers
DELETE /seller-api/sellers/123/ads/456/images HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf

Response

Response statusExplanation
204 (No Content)success
404 (not found)You provided a wrong seller-key or a wrong ad-key.
Example status-line and headers
HTTP/1.1 204 No Content

Retrieve ad statistics

It is possible to retrieve important success metrics for an ad. This function delivers strictly private information, which must not be displayed to any other user except the corresponding customer. It is not allow to store this information longer than the duration of the ad it relates to or to aggregate this data.

You need special permission to be able to do this API call.

Request

Resource pathMethodContent-Type / Accept header
/seller-api/sellers/{seller-key}/ads/{ad-key}/statisticGETapplication/vnd.de.mobile.ad-statistic-v2.0+xml
Example request-line and headers
GET /seller-api/sellers/123/ads/456/statistic HTTP/1.0
Host: services.mobile.de
Accept: application/vnd.de.mobile.ad-statistic-v2.0+xml
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf

Response

Response statusExplanation
200 (OK)success
403 (Forbidden)You are missing the permission to get the statistics.
404 (not found)You provided a wrong seller-key or a wrong ad-key.

Impressum / Imprint