Mobile.de API
## Mobile.de Vehicle API Real-time, normalized access to **Germany's leading vehicle marketplace** — over **1.5 million active listings** across **13 vehicle classes**. Search with 40+ filters, pull complete listing details, and resolve the full make/model/filter taxonomy through clean, privacy-aware JSON. ### Why this API - **1.5M+ live listings** — cars, motorbikes, e-bikes, motorhomes, vans,…
Mobile.de API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Search | ||
| GET |
countVehicles /search/count |
Returns only the total number of listings matching the filters — no items fetched. Accepts the same filters as `/search` (vc defaults to `Car`). Ideal for showing result counts… |
| GET |
searchVehicles /search |
Search listings for a vehicle class with filters. ENUM filters accept only fixed values from `/reference/filters/{vc}` (deny-by-default; invalid or class-unsupported values… |
| Listings | ||
| GET |
getListings /listings |
Returns a paginated list of vehicle listings — same engine and filters as `/search`. No ID required: call with no parameters to get all cars (defaults to `vc=Car`), or add any… |
| GET |
getSimilarListings /listings/{id}/similar |
Returns listings similar to the given listing (same make/model, category and price band). Uses the same item schema as `/search`. The `{id}` is a listing ID from `/search`… |
| GET |
getListing /listings/{id} |
Returns the complete detail of one listing by its numeric ID (`id` from `/search` results). Includes the full technical spec table (`attributes`), equipment (`features`), all… |
| Reference | ||
| GET |
getMakes /reference/makes/{vc} |
Alphabetically sorted list of all makes (manufacturers) for the vehicle class, each with a numeric `id`. Workflow: `GET /reference/makes/Car` → find BMW `id: 3500` → `GET… |
| GET |
health /health |
|
| GET |
getFilters /reference/filters/{vc} |
Returns every valid ENUM filter value for the given vehicle class, grouped by filter (e.g. `fuels`, `gears`, `categories`, `colors`, `features`, `emissions`). Each entry is `{… |
| GET |
getModels /reference/models/{makeId} |
All models for a make, with group hierarchy. `isGroup: true` marks a heading (e.g. "3 Series"); `parentId` links a model to its group. Use the model `id` in `/search` via… |
| GET |
getVehicleClasses /reference/vehicle-classes |
Returns all 13 supported `vc` values. Every search is scoped to one vehicle class, and each class has its own valid filter values (`/reference/filters/{vc}`) and make/model… |
| GET |
getModelsByClass /reference/models/by-class/{vc} |
Returns **every make of a vehicle class together with all its models** in a single response — the whole picker tree, so you never call `/reference/makes/{vc}` then… |
| GET |
getModelsBatch /reference/models |
Returns the model catalog for **several makes at once**, so you don't have to call `/reference/models/{makeId}` once per make. Pass a comma-separated list of make IDs via… |
| Dealers | ||
| GET |
getDealerListings /dealers/{id}/listings |
Returns the listings published by a specific dealer (search filtered by seller ID). Get `{id}` from the `seller.id` field of any dealer (`type: DEALER`) result in `/search` or… |
| GET |
getDealerRatings /dealers/{id}/ratings |
Returns a dealer's rating summary: star distribution, total review count, member tenure, and highlighted customer reviews. Get `{id}` from the `seller.id` field of any dealer… |
| Other endpoints | ||
| GET |
getDealerListings /dealers/{id}/listings |
Returns the listings published by a specific dealer (search filtered by seller ID). Same item schema as `/search`. `vc` defaults to `Car`. |
| GET |
getDealerRatings /dealers/{id}/ratings |
Returns a dealer's rating summary: star distribution, total review count, member tenure, and highlighted customer reviews. The `{id}` is the dealer/seller ID (e.g.… |
| GET |
getListing /listings/{id} |
Returns the complete detail of one listing by its numeric ID (`id` from `/search` results). Includes the full technical spec table (`attributes`), equipment (`features`), all… |
| GET |
searchVehicles /search |
Search listings for a vehicle class with filters. ENUM filters accept only fixed values from `/reference/filters/{vc}` (deny-by-default; invalid or class-unsupported values… |
| GET |
countVehicles /search/count |
Returns only the total number of listings matching the filters — no items fetched. Accepts the same filters as `/search` (vc defaults to `Car`). Ideal for showing result counts… |
| GET |
getSimilarListings /listings/{id}/similar |
Returns listings similar to the given listing (same make/model, category and price band). Uses the same item schema as `/search`. The `{id}` is a listing ID from `/search` results. |
| GET |
getListings /listings |
Returns a paginated list of vehicle listings — same engine and filters as `/search`. No ID required: call with no parameters to get all cars (defaults to `vc=Car`), or add any… |
| GET |
getFilters /reference/filters/{vc} |
Returns every valid ENUM filter value for the given vehicle class, grouped by filter (e.g. `fuels`, `gears`, `categories`, `colors`, `features`, `emissions`). Each entry is `{… |
| GET |
health /health |
|
| GET |
getMakes /reference/makes/{vc} |
Alphabetically sorted list of all makes (manufacturers) for the vehicle class, each with a numeric `id`. Workflow: `GET /reference/makes/Car` → find BMW `id: 3500` → `GET… |
| GET |
getModels /reference/models/{makeId} |
All models for a make, with group hierarchy. `isGroup: true` marks a heading (e.g. "3 Series"); `parentId` links a model to its group. Use the model `id` in `/search` via… |
| GET |
getVehicleClasses /reference/vehicle-classes |
Returns all 13 supported `vc` values. Every search is scoped to one vehicle class, and each class has its own valid filter values (`/reference/filters/{vc}`) and make/model… |
Mobile.de API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $6.99 / month | — |
|
| ULTRA | $14.99 / month | — |
|
| MEGA | $24.99 / month | — |
|