Piloterr

Mobile Search

GET
/v2/mobile/search

Mobile Search API. Same mobile.de inventory for every locale. locale sets the language label and ad links, not which cars are returned. (3 credits)

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Search URL or make/model code (ms=).

Examples:

20100
https://www.mobile.de/fr/voiture/recherche.html?ms=20100&s=Car&vc=Car
https://suchen.mobile.de/fahrzeuge/search.html?s=Car&vc=Car

Use Mobile Ad on any result url or ad_id for full listing data.

locale?string

Locale label for the results. The cars themselves stay the same for de, fr, and en.

Examples: fr, de, en, es.

A suchen.mobile.de search URL is read as the French search, with the same filters.

page?number

Page number, starting at 1. Same effect as page or pageNumber in the Mobile.de URL.

The response next uses pageNumber for the following page: page 1 links to pageNumber=2, page 2 links to pageNumber=3.

Range1 <= value <= 500
return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/mobile/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.mobile.de/fr/voiture/d%C3%A9tails.html?id=455007337&s=Car&vc=Car",      "make": "Porsche",      "ad_id": "455007337",      "model": "Cayman",      "power": "265 kW (360 ch)",      "price": 54990,      "title": "Porsche Cayman S PDK",      "locale": "fr",      "mileage": "22.500 km",      "currency": "EUR",      "location": "München",      "fuel_type": "Essence",      "image_url": "https://img.classistatic.de/api/v1/mo-prod/images/jpg/normal/95/mt_mte247ax-wr.jpg",      "price_rating": "GOOD_PRICE",      "transmission": "Automatique",      "first_registration": "03/2021",      "price_rating_label": "Bon prix"    }  ],  "pagination": {    "next": null,    "page": 1,    "per_page": 50,    "total_pages": null,    "total_results": null  }}