# mobile.de API > mobile.de returns car listings and vehicle details as a workflow and API. mobile.de, also called mobile.de cars, returns matching car listings through Search cars. Search cars needs a make and model; optional inputs include year, price, mileage, fuel, condition, and sorting. - Page: https://fous.com/tools/mobile-de - Handle: `@mobile-de` - Category: [Commerce](https://fous.com/tools/category/commerce) - Source website: https://mobile.de - Last verified: Sep 29, 2026 ## Methods ### Search cars Operation `search_cars`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. Search mobile.de car listings by make and model, with optional registration year, price, mileage, fuel, condition, and sorting. Returns up to 50 listings in marketplace order; fields not shown on a listing are null. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `fuel` | string | no | `"hybrid"` | Fuel type, for example diesel; any includes all fuels. | | `make` | string | yes | `"Volkswagen"` | Car make, for example Volkswagen. | | `sort` | string | no | `"newest_listings"` | Listing order, for example price_low_to_high. | | `model` | string | yes | `"Golf"` | Car model, for example Golf. | | `max_year` | integer | no | `2025` | Latest first-registration year, for example 2025. | | `min_year` | integer | no | `2020` | Earliest first-registration year, for example 2020. | | `condition` | string | no | `"used"` | Vehicle condition, for example used. | | `max_price` | integer | no | `1` | Maximum price in EUR, for example 15000. | | `min_price` | integer | no | `5000` | Minimum price in EUR, for example 5000. | | `max_results` | integer | no | `5` | Maximum number of cars to return, for example 20. | | `max_mileage_km` | integer | no | `100000` | Maximum mileage in kilometres, for example 100000. | **Input schema** ```json { "type": "object", "required": [ "make", "model" ], "properties": { "fuel": { "enum": [ "any", "petrol", "diesel", "electric", "hybrid" ], "type": "string", "default": "any", "description": "Fuel type, for example diesel; any includes all fuels.", "examples": [ "hybrid", "diesel", "electric" ] }, "make": { "type": "string", "description": "Car make, for example Volkswagen.", "examples": [ "Volkswagen", "Toyota", "Tesla" ] }, "sort": { "enum": [ "standard", "price_low_to_high", "newest_listings", "lowest_mileage" ], "type": "string", "default": "standard", "description": "Listing order, for example price_low_to_high.", "examples": [ "newest_listings", "price_low_to_high", "lowest_mileage" ] }, "model": { "type": "string", "description": "Car model, for example Golf.", "examples": [ "Golf", "Yaris", "Model 3" ] }, "max_year": { "type": "integer", "minimum": 1900, "description": "Latest first-registration year, for example 2025.", "examples": [ 2025 ] }, "min_year": { "type": "integer", "minimum": 1900, "description": "Earliest first-registration year, for example 2020.", "examples": [ 2020 ] }, "condition": { "enum": [ "any", "used", "new" ], "type": "string", "default": "any", "description": "Vehicle condition, for example used.", "examples": [ "used", "new" ] }, "max_price": { "type": "integer", "minimum": 0, "description": "Maximum price in EUR, for example 15000.", "examples": [ 1, 15000 ] }, "min_price": { "type": "integer", "minimum": 0, "description": "Minimum price in EUR, for example 5000.", "examples": [ 5000 ] }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of cars to return, for example 20.", "x-fous-developer": true, "examples": [ 5, 30, 50 ] }, "max_mileage_km": { "type": "integer", "minimum": 0, "description": "Maximum mileage in kilometres, for example 100000.", "examples": [ 100000 ] } }, "additionalProperties": false, "examples": [ { "make": "Volkswagen", "model": "Golf", "max_results": 5 }, { "fuel": "hybrid", "make": "Toyota", "sort": "newest_listings", "model": "Yaris", "max_results": 30 }, { "make": "Volkswagen", "model": "Golf", "max_price": 1 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `cars` | array | | Matching car listings in mobile.de order. | | `cars[].fuel` | string or null | `"Petrol"` | Fuel type shown on the listing. | | `cars[].price` | number or null | `29345` | Displayed asking price. | | `cars[].title` | string or null | `"Volkswagen Golf GTI DSG Navi BlackStyle Pano RearView LED"` | Listing title. | | `cars[].currency` | string or null | `"EUR"` | Price currency, EUR. | | `cars[].location` | string or null | `"33613 Bielefeld"` | Seller postcode and city. | | `cars[].power_hp` | integer or null | `245` | Engine power in horsepower. | | `cars[].power_kw` | integer or null | `180` | Engine power in kilowatts. | | `cars[].image_link` | string or null | `"https://img.classistatic.de/api/v1/mo-prod/images/f9/f9ed5f80-c6a6-440a-ac59-de16f6e2e8f2?rule=mo-160w"` | Main vehicle image link. | | `cars[].listing_id` | string or null | `"455885755"` | Mobile.de listing identifier. | | `cars[].mileage_km` | integer or null | `42801` | Mileage in kilometres. | | `cars[].seller_name` | string or null | `"Autohaus Steinböhmer GmbH & Co KG"` | Seller name. | | `cars[].seller_type` | string or null | `"dealer"` | Seller category: dealer or private. | | `cars[].listing_link` | string or null | `"https://www.mobile.de/auto-inserat/volkswagen-golf-gti-dsg-navi-blackstyle-pano-rearview-led-bielefeld/455885755.html"` | Car listing page link. | | `cars[].price_rating` | string or null | `"Fair price"` | Price rating shown on the listing. | | `cars[].transmission` | string or null | `"Automatic"` | Transmission shown on the listing. | | `cars[].first_registration` | string or null | `"2024-03"` | First registration, YYYY-MM. | **Example input** ```json { "make": "Volkswagen", "model": "Golf", "max_results": 5 } ``` **Example output** ```json { "cars": [ { "fuel": "Petrol", "price": 29345, "title": "Volkswagen Golf GTI DSG Navi BlackStyle Pano RearView LED", "currency": "EUR", "location": "33613 Bielefeld", "power_hp": 245, "power_kw": 180, "image_link": "https://img.classistatic.de/api/v1/mo-prod/images/f9/f9ed5f80-c6a6-440a-ac59-de16f6e2e8f2?rule=mo-160w", "listing_id": "455885755", "mileage_km": 42801, "seller_name": "Autohaus Steinböhmer GmbH & Co KG", "seller_type": "dealer", "listing_link": "https://www.mobile.de/auto-inserat/volkswagen-golf-gti-dsg-navi-blackstyle-pano-rearview-led-bielefeld/455885755.html", "price_rating": "Fair price", "transmission": "Automatic", "first_registration": "2024-03" }, { "fuel": "Petrol", "price": 17670, "title": "Volkswagen Golf VII 2.0 TSI GTI Performance BMT*LED*ACC*PDC", "currency": "EUR", "location": "85375 Neufahrn b. Freising", "power_hp": 245, "power_kw": 180, "image_link": "https://img.classistatic.de/api/v1/mo-prod/images/27/27183272-2ab9-4495-897a-776ecfec438a?rule=mo-160w", "listing_id": "461430737", "mileage_km": 103319, "seller_name": "Autohero GmbH - Abholstation München", "seller_type": "dealer", "listing_link": "https://www.mobile.de/auto-inserat/volkswagen-golf-vii-2-0-tsi-gti-performance-bmt-led-acc-pdc-neufahrn-b-freising/461430737.html", "price_rating": "No rating", "transmission": "Manual gearbox", "first_registration": "2017-08" } ] } ``` ## Quick start Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data. ```bash curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 180 \ -H "Authorization: Bearer YOUR_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "api": "@mobile-de", "visibility": "public", "operation": "search_cars", "version": 1, "input": { "make": "Volkswagen", "model": "Golf", "max_results": 5 }, "response": { "format": "json" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. import json import urllib.error import urllib.request api_key = "YOUR_API_KEY" body = json.loads("{\n \"api\": \"@mobile-de\",\n \"visibility\": \"public\",\n \"operation\": \"search_cars\",\n \"version\": 1,\n \"input\": {\n \"make\": \"Volkswagen\",\n \"model\": \"Golf\",\n \"max_results\": 5\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=180) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. const apiKey = "YOUR_API_KEY"; const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(180_000), body: JSON.stringify({ "api": "@mobile-de", "visibility": "public", "operation": "search_cars", "version": 1, "input": { "make": "Volkswagen", "model": "Golf", "max_results": 5 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` ## Use from an AI assistant Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input. - Server URL: `https://api.fous.com/mcp/tools/mobile-de` - Authorization: `Authorization: Bearer ` **Tools** - `search_cars`: Search cars. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted. - `fous_get_run`: the result of a run that was still going, by its `request_id`. Free. Claude Code: ```bash claude mcp add --scope user --transport http fous-mobile-de https://api.fous.com/mcp/tools/mobile-de --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}" ``` To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt. ## Use cases - Compare asking prices for cars by make and model - Find listings within a price range - Review mileage and first-registration dates - Compare fuel types and transmissions - Identify dealer and private listings ## FAQ ### Can I run it with my own inputs? Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant. ### Can I call this mobile.de tool as an API? Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back. ### How much does it cost? Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit. ### Do I need a mobile.de account? No. You only need a Fous account. ### How current is the data? Fous gets the data from mobile.de when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026. ### What cars match a make and model? Search cars returns matching listings when you provide a make and model. ### Which listings fall within a price range? Search cars accepts minimum and maximum prices and returns matching listings. ### What details are shown for each listing? Search cars returns available details such as price, mileage, fuel, transmission, location, and first registration. ## Related - [Cars.com API](https://fous.com/tools/cars-com.md): Cars.com finds car listings by make, model, and U.S. ZIP code, and provides dealerships’ latest customer reviews when available. - [Autotrader API](https://fous.com/tools/autotrader.md): Search new, used and certified cars for sale across the United States. - [CarGurus API](https://fous.com/tools/cargurus.md): CarGurus helps shoppers browse dealer-listed new and used cars with deal ratings, and view average used prices, price ranges and 12-month price history by model year. - [Carvana API](https://fous.com/tools/carvana.md): Search used vehicles for sale on Carvana. - [CarMax API](https://fous.com/tools/carmax.md): Search public CarMax used-car listings. - [Carfax API](https://fous.com/tools/carfax.md): Carfax provides used-car listings near a US ZIP code with free history highlights, plus open safety recalls reported by CARFAX for a VIN or US plate. - [Mercari API](https://fous.com/tools/mercari.md): Search secondhand and sold listings on Mercari US. - [ImmoScout24 API](https://fous.com/tools/immoscout24.md): Search apartments and houses across Germany. - [All Commerce tools](https://fous.com/tools/category/commerce)