---
title: "Scrape mobile.de car listings"
method: POST
path: "/vehicles/mobile-de"
tags: ["Plugins"]
---

# Scrape mobile.de car listings

`POST /vehicles/mobile-de`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/vehicles/mobile-de`
- Auth: API key in header `x-scrapeunblocker-key`

Searches mobile.de (Germany's largest car marketplace) and returns the result-list cards as JSON: `title`, `makeModel`, `price` (numeric EUR) plus `priceFormatted`, `firstRegistration`, `mileage`, `power` (`kw` + `ps`), `fuel`, and the detail `id` + `url`. Pass a friendly `make` name (or a raw `make_id`), and filter with `price_min`/`price_max`, `year_min`, `mileage_max` and `fuel`; collect up to `max_results` across pages. `model` is accepted as free text but is not used to filter (mobile.de needs a numeric model id we do not resolve).

## Query parameters

- `make` string, nullable: Make name, e.g. 'bmw', 'volkswagen', 'audi'. Required unless `make_id` is given.
- `make_id` integer, nullable: Raw mobile.de numeric make id, overrides `make` (e.g. 3500 = BMW).
- `model` string, nullable: Model name (free text). Model-id resolution is not available, so it is used only as a note; results are not filtered by model.
- `price_min` integer, nullable: Minimum price in EUR.
- `price_max` integer, nullable: Maximum price in EUR.
- `year_min` integer, nullable: Earliest first-registration year (YYYY).
- `mileage_max` integer, nullable: Maximum mileage in km.
- `fuel` string, nullable: Fuel: petrol, diesel, electric, hybrid (or a raw mobile.de code).
- `max_results` integer: How many listings to collect across pages (~20 per page).
- `page` integer: 1-based results page to start from.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Leave blank to let the API pick.

## Response `200`

JSON with a `listings` array plus counts.

- unknown

## Other responses

- `400`: Invalid parameters (e.g. unknown make).
- `422`: Validation Error
- `502`: Blocked by mobile.de, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)