mobile.de API: Search cars
Searches 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.
Unofficial. Not affiliated with or endorsed by mobile.de.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Fuel optional
fuel Fuel type, for example diesel; any includes all fuels.
hybrid
One of
any,petrol,diesel,electric,hybrid. Defaultany.- Make, required
make Car make, for example Volkswagen.
Toyota
- Sort optional
sort Listing order, for example price_low_to_high.
newest_listings
One of
standard,price_low_to_high,newest_listings,lowest_mileage. Defaultstandard.- Model, required
model Car model, for example Golf.
Yaris
- Max Year optional
max_year Latest first-registration year, for example 2025.
Not set
Whole number 1900 or more.
- Min Year optional
min_year Earliest first-registration year, for example 2020.
Not set
Whole number 1900 or more.
- Condition optional
condition Vehicle condition, for example used.
any (default)
One of
any,used,new.- Max Price optional
max_price Maximum price in EUR, for example 15000.
Not set
Whole number 0 or more.
- Min Price optional
min_price Minimum price in EUR, for example 5000.
Not set
Whole number 0 or more.
- Max Results optional
max_results Maximum number of cars to return, for example 20.
30
Whole number from 1 to 50. Default
20.- Max Mileage (km) optional
max_mileage_km Maximum mileage in kilometres, for example 100000.
Not set
Whole number 0 or more.
Input as JSON
{ "fuel": "hybrid", "make": "Toyota", "sort": "newest_listings", "model": "Yaris", "max_results": 30}Output
{ "cars": [ { "fuel": "Hybrid (petrol/electric)" , "price": 26888, "title": "Toyota Yaris Hybrid Style 1.5 Safety Paket Apple CarPla", "currency": "EUR", "location": "52525 Heinsberg", "power_hp": 131, "power_kw": 96, "image_link": "https://img.classistatic.de/api/v1/mo-prod/images/17/1740e3bb-4b1f-462e-84bd-8206f8da6f9b?rule=mo-160w" , "listing_id": "438765984", "mileage_km": 10, "seller_name": "Auto-Koch GmbH & Co. KG", "seller_type": "dealer", "listing_link": "https://www.mobile.de/auto-inserat/toyota-yaris-hybrid-style-1-5-safety-paket-apple-carpla-heinsberg/438765984.html" , "price_rating": "Fair price", "transmission": "Automatic", "first_registration": "2025-11" }, { "fuel": "Hybrid (petrol/electric)" , "price": 12899, "title": "Toyota TOYOTA Yaris 1.5 Hybrid 5 porte Active", "currency": "EUR", "location": "IT-87100 Cosenza", "power_hp": 73, "power_kw": 54, "image_link": "https://img.classistatic.de/api/v1/mo-prod/images/5e/5e7eaa9e-7dd5-4e4a-aacb-adf2de68f940?rule=mo-160w" , "listing_id": "47963853190432", "mileage_km": 94780, "seller_name": "AUTOHERO ITALIA COSENZA", "seller_type": "dealer", "listing_link": "https://www.mobile.de/auto-inserat/toyota-toyota-yaris-1-5-hybrid-5-porte-active-cosenza/47963853190432.html" , "price_rating": "Fair price", "transmission": "Automatic", "first_registration": "2019-05" }, { "fuel": "Hybrid (petrol/electric)" , "price": 19499, "title": "Toyota TOYOTA Yaris 1.5 Hybrid 5 porte Trend", "currency": "EUR", "location": "IT-87100 Cosenza", "power_hp": 92, "power_kw": 68, "image_link": "https://img.classistatic.de/api/v1/mo-prod/images/ee/ee0c2aa1-5212-41c0-922b-f3270a4f43ed?rule=mo-160w" , "listing_id": "47963834268960", "mileage_km": 24821, "seller_name": "AUTOHERO ITALIA COSENZA", "seller_type": "dealer", "listing_link": "https://www.mobile.de/auto-inserat/toyota-toyota-yaris-1-5-hybrid-5-porte-trend-cosenza/47963834268960.html" , "price_rating": "Fair price", "transmission": "Automatic", "first_registration": "2023-05" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"mobile.de/search_cars","input":{"fuel":"hybrid","make":"Toyota","sort":"newest_listings","model":"Yaris","max_results":30}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "mobile.de/search_cars" , "input": { "fuel": "hybrid", "make": "Toyota", "sort": "newest_listings", "model": "Yaris", "max_results": 30 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "mobile.de/search_cars" , "input": { "fuel": "hybrid", "make": "Toyota", "sort": "newest_listings", "model": "Yaris", "max_results": 30 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run mobile.de/search_cars# with {"fuel":"hybrid","make":"Toyota","sort":"newest_listings","model":"Yaris","max_results":30}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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." }, "make": { "type": "string", "description": "Car make, for example Volkswagen." }, "sort": { "enum": [ "standard", "price_low_to_high", "newest_listings", "lowest_mileage" ], "type": "string", "default": "standard", "description": "Listing order, for example price_low_to_high." }, "model": { "type": "string", "description": "Car model, for example Golf." }, "max_year": { "type": "integer", "minimum": 1900, "description": "Latest first-registration year, for example 2025." }, "min_year": { "type": "integer", "minimum": 1900, "description": "Earliest first-registration year, for example 2020." }, "condition": { "enum": [ "any", "used", "new" ], "type": "string", "default": "any", "description": "Vehicle condition, for example used." }, "max_price": { "type": "integer", "minimum": 0, "description": "Maximum price in EUR, for example 15000." }, "min_price": { "type": "integer", "minimum": 0, "description": "Minimum price in EUR, for example 5000." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of cars to return, for example 20." }, "max_mileage_km": { "type": "integer", "minimum": 0, "description": "Maximum mileage in kilometres, for example 100000." } }}Output schema
{ "type": "object", "required": [ "cars" ], "properties": { "cars": { "type": "array", "items": { "type": "object", "required": [ "title", "price", "currency", "price_rating", "first_registration", "mileage_km", "power_kw", "power_hp", "fuel", "transmission", "seller_type", "seller_name", "location", "image_link", "listing_link", "listing_id" ], "properties": { "fuel": { "type": [ "string", "null" ], "description": "Fuel type shown on the listing." }, "price": { "type": [ "number", "null" ], "description": "Displayed asking price." }, "title": { "type": [ "string", "null" ], "description": "Listing title." }, "currency": { "type": [ "string", "null" ], "description": "Price currency, EUR." }, "location": { "type": [ "string", "null" ], "description": "Seller postcode and city." }, "power_hp": { "type": [ "integer", "null" ], "description": "Engine power in horsepower." }, "power_kw": { "type": [ "integer", "null" ], "description": "Engine power in kilowatts." }, "image_link": { "type": [ "string", "null" ], "description": "Main vehicle image link." }, "listing_id": { "type": [ "string", "null" ], "description": "Mobile.de listing identifier." }, "mileage_km": { "type": [ "integer", "null" ], "description": "Mileage in kilometres." }, "seller_name": { "type": [ "string", "null" ], "description": "Seller name." }, "seller_type": { "type": [ "string", "null" ], "description": "Seller category: dealer or private." }, "listing_link": { "type": [ "string", "null" ], "description": "Car listing page link." }, "price_rating": { "type": [ "string", "null" ], "description": "Price rating shown on the listing." }, "transmission": { "type": [ "string", "null" ], "description": "Transmission shown on the listing." }, "first_registration": { "type": [ "string", "null" ], "description": "First registration, YYYY-MM." } }, "additionalProperties": false }, "description": "Matching car listings in mobile.de order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
mobile.de/search_cars- Returns
- title, price, rating, registration, mileage, power, fuel, transmission, seller, location, image, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method mobile.de/search_cars with the inputs above.
Ask your agent
- Find used diesel BMW 320d cars registered 2018 or later under €20,000 on mobile.de, cheapest first
- Show me the newest listings for a Tesla Model 3 under 60,000 km, up to 30 results
- I'm looking for a petrol Volkswagen Polo from 2015–2019 with less than 90000 km, budget between 6k and 11k euros
- What new Skoda Octavia hybrids are currently listed on mobile.de? Give me 10
- Audi A4 Avant, used, max 150,000 km, sorted by lowest mileage, priced under 18000 EUR
See more
Searches Cars.com car listings for a make and model around a US ZIP code within a radius, optionally by condition (new, used or certified pre-owned) and maximum price, in Cars.com search order.
cars.com/search_carsSearches Autotrader car listings near a US ZIP code by make and model, with condition, price, year and distance filters. Returns up to 100 listings in site order.
autotrader.com/search_carsSearches CARFAX used-car listings for a make and model near a US ZIP code, in CARFAX order, with listing details and free vehicle-history highlights. Paid full history reports are not included.
carfax.com/search_carsSearches CarMax used cars by make and model with optional ZIP, distance, year, price and mileage filters, keeping CarMax's order. Pages expose only the first 48 cars; distance is CarMax's distance from the selected local store, and larger limits or narrow distance filters may return fewer matches.
carmax.com/search_carsSearches new and used cars for sale near a US ZIP code for a make and model, with prices, dealer details and CarGurus deal ratings. Used cars come first, then new cars, each in CarGurus order; market difference is positive below market and negative above.
cargurus.com/search_carsSearches Carvana's used-car inventory by make and model, with optional price, year, mileage and ZIP filters, and returns each car's price, estimated monthly payment, mileage and delivery or pickup estimate for the ZIP.
carvana.com/search_carsSearches Mercari US listings for items for sale or sold, with condition, price and sorting filters, and adds seller, size and shipping details from each item page. Sold prices are displayed listing prices.
mercari.com/search_listingsFinds OfferUp items for sale near a US city or ZIP code, with prices, condition, seller names, distance and links. Distances use approximate listing locations.
offerup.com/search_listings