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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch URL or make/model code (ms=).
Examples:
20100https://www.mobile.de/fr/voiture/recherche.html?ms=20100&s=Car&vc=Carhttps://suchen.mobile.de/fahrzeuge/search.html?s=Car&vc=CarUse Mobile Ad on any result url or ad_id for full listing data.
locale?stringLocale 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?numberPage 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.
1 <= value <= 500return_page_source?booleanWhen true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/mobile/search?query=string'{ "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 }}