# Mobile.de Vehicle Listings and Price Rating Scraper (`nimbryxo-studio/mobile-de-vehicle-listings-and-price-rating`) Actor

Search mobile.de vehicle listings by model or search URL and get mobile.de's own price-fairness rating alongside specs, mileage, fuel type, emissions class and dealer contact for every car.

- **URL**: https://apify.com/nimbryxo-studio/mobile-de-vehicle-listings-and-price-rating.md
- **Developed by:** [Nimbryxo-studio](https://apify.com/nimbryxo-studio) (community)
- **Categories:** Automation, E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Mobile.de Vehicle Listings and Price Rating Scraper

Mobile.de is Germany's largest vehicle marketplace, with over a million live listings for cars, vans and estate cars. This actor turns a mobile.de spec page or search URL into a flat dataset of vehicles, each carrying mobile.de's own "is this a good price?" rating alongside full specs and dealer contact details.

### What this actor does

- Accepts either a mobile.de spec page URL (e.g. `suchen.mobile.de/auto/volkswagen-golf.html`) or a legacy filtered search URL, and walks its result pages up to your requested item count
- Deduplicates by listing ID, since mobile.de repeats promoted "top ads" across multiple result pages
- Carries through mobile.de's own price-fairness verdict (`priceRating`) for each vehicle, when the listing has one
- Keeps numeric fields (price, mileage, power, year, seats, etc.) at `0` when mobile.de didn't disclose a value, and omits text fields entirely when they're missing, so you never have to handle `null`
- Works without logging in or accepting cookies

### Output per vehicle

#### Identity

- `id` — mobile.de listing ID
- `url` — full listing URL
- `title`, `shortTitle`, `subTitle` — full title, make+model only, and the variant/trim text
- `make`, `model`, `category` — manufacturer, model name, body category (Estate car, Sedan, SUV, etc.)
- `vehicleClass` — vehicle class code

#### Price

- `price`, `currency`, `priceFormatted` — gross price as an integer, currency code, and mobile.de's formatted price string
- `priceRating` — `VERY_GOOD_PRICE`, `GOOD_PRICE`, `FAIR_PRICE`, `INCREASED_PRICE` or `HIGH_PRICE`

#### Specifications

- `mileageKm`, `powerKw`, `powerHp`
- `firstRegistration`, `yearConstructed`
- `fuelType`, `transmission`, `bodyType`, `exteriorColor`, `doors`, `seats`
- `previousOwners`
- `emissionClass`, `co2Class`, `consumption`, `displacementCcm`

#### Media and dealer

- `numImages`, `previewImage`
- `location`, `postalCode`, `country`
- `dealerName`, `dealerType` (`DEALER` or `PRIVATE`), `dealerPhone`

#### Metadata

- `scrapedAt` — ISO 8601 scrape timestamp

If mobile.de blocks every access path during a run, the dataset instead gets a single status record with `status` (`blocked` or `error`), `site`, `reason`, and `scrapedAt`.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `startUrls` | array | `["https://suchen.mobile.de/auto/volkswagen-golf.html"]` | Mobile.de spec page URLs or legacy `search.html?...` URLs |
| `maxItems` | integer | `50` | Maximum number of vehicles to return (1–500) |
| `proxyConfiguration` | object | Apify RESIDENTIAL (DE) | Used automatically only if the first direct attempt is blocked |
| `forceResidentialProxy` | boolean | `false` | Skip the direct-connection attempt and use the configured proxy from the first request |

#### Example: a specific model's current listings

```json
{
    "startUrls": ["https://suchen.mobile.de/auto/volkswagen-golf.html"],
    "maxItems": 100
}
```

#### Example: legacy search URL with price and fuel filters

```json
{
    "startUrls": [
        "https://suchen.mobile.de/fahrzeuge/search.html?isSearchRequest=true&s=Car&vc=Car&ms=1900;17;;;&fr=2020&ft=DIESEL&mnp=30000"
    ],
    "maxItems": 200
}
```

#### Example: force the residential proxy on short-timeout schedules

```json
{
    "startUrls": ["https://suchen.mobile.de/auto/bmw-m3.html"],
    "maxItems": 50,
    "forceResidentialProxy": true
}
```

### Use cases

- **Used-car market research** — track price distribution and inventory age by make and model
- **Deal hunting** — filter on `priceRating` to surface listings mobile.de itself flags as a good deal
- **Dealer monitoring** — watch a specific dealer's inventory for new or changed listings
- **Regional comparisons** — scope a search URL to a postal-code radius and compare local pricing
- **EV market tracking** — filter the results on `fuelType` to follow electric and hybrid supply over time

### FAQ

**Is this affiliated with mobile.de?**
No. This is an independent actor that reads publicly available mobile.de listing pages; it has no affiliation with mobile.de.

**Why do I get a `dealerType` of `PRIVATE` on some listings?**
mobile.de lists both trade dealers and private sellers; `dealerType` reflects whichever the listing itself declares.

**Why are there fewer unique vehicles than `maxItems` implies?**
mobile.de repeats promoted "top ads" across multiple pages of the same search; this actor deduplicates by listing ID, so the figure you get is the count of distinct vehicles, not raw rows fetched.

**Do I need a proxy?**
Not necessarily. The actor tries a direct connection first and only uses the configured proxy as a fallback if that's blocked. Set `forceResidentialProxy` to `true` to skip straight to the proxy if your runs are hitting blocks or run on a short timeout.

**Can I point `startUrls` at any mobile.de page?**
It expects either a spec page (`suchen.mobile.de/auto/*.html`) or a filtered search page (`suchen.mobile.de/fahrzeuge/search.html?...`) — paste the URL straight from your browser after applying filters on the site.

**How fresh is the data?**
Each run reads the current mobile.de result pages live, so prices and availability reflect what's listed at run time.

**Why are fields never `null`?**
Numeric fields (price, mileage, power, year, seats, and the like) default to `0` when mobile.de didn't disclose a value, rather than `null`. Text fields are simply left out of the record when they're missing, the same as a blank string.

# Actor input Schema

## `startUrls` (type: `array`):

Mobile.de spec page URLs (suchen.mobile.de/auto/\*.html format, e.g. https://suchen.mobile.de/auto/volkswagen-golf.html) or legacy search URLs (suchen.mobile.de/fahrzeuge/search.html?...). Spec page URLs are recommended — they embed full car listing data directly in the page.

## `maxItems` (type: `integer`):

Maximum number of vehicles to return.

## `proxyConfiguration` (type: `object`):

Optional — mobile.de is protected by Akamai Bot Manager. The actor first tries a direct connection (works from most Apify regions) and automatically falls back to this proxy if blocked. Recommended: Apify RESIDENTIAL proxy with country DE.

## `forceResidentialProxy` (type: `boolean`):

By default the actor tries a direct connection first and only falls back to the proxy above if blocked. Enable this to always use the proxy from the first attempt — recommended if your runs are seeing repeated 'access denied' errors or you're running on a short timeout, since skipping the (currently unreliable) direct attempt saves time and cost.

## Actor input object example

```json
{
  "startUrls": [
    "https://suchen.mobile.de/auto/volkswagen-golf.html"
  ],
  "maxItems": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  },
  "forceResidentialProxy": false
}
```

# Actor output Schema

## `cars` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://suchen.mobile.de/auto/volkswagen-golf.html"
    ],
    "maxItems": 3,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "DE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nimbryxo-studio/mobile-de-vehicle-listings-and-price-rating").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": ["https://suchen.mobile.de/auto/volkswagen-golf.html"],
    "maxItems": 3,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("nimbryxo-studio/mobile-de-vehicle-listings-and-price-rating").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://suchen.mobile.de/auto/volkswagen-golf.html"
  ],
  "maxItems": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}' |
apify call nimbryxo-studio/mobile-de-vehicle-listings-and-price-rating --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/mobile-de-vehicle-listings-and-price-rating"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0Vy75WS7WpVWfBa3b/builds/1ujeNfSeTrBcno2kK/openapi.json
