# Mobile.de Cars Scraper (`neuro-scraper/mobile-de-cars-scraper`) Actor

Mobile.de Cars Scraper SD - Mobile.de Cars Scraper is a logged-out tool that extracts car listings from mobile.de searches and listing links: price, price rating, mileage, first registration, power, fuel, equipment, description, images, finance offer, dealer details and dealer reviews.

- **URL**: https://apify.com/neuro-scraper/mobile-de-cars-scraper.md
- **Developed by:** [Neuro Scraper](https://apify.com/neuro-scraper) (community)
- **Categories:** E-commerce, Automation, 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 $1.19 / 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

./README.md

# Actor input Schema

## `searchTerms` (type: `array`):

Free-text car searches, one per line, as typed into mobile.de's search box (mobile.de's full-text search: it matches the words in titles and descriptions - for an exact make and model use Models). Every result page is read until Max items. The filters below apply to every search term. Example: Volkswagen Golf GTI

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

mobile.de links: a search results page copied from the address bar (https://suchen.mobile.de/fahrzeuge/search.html?...\&ms=3500%3B%3B%3B\&vc=Car - its own filters are used) or a single listing (https://suchen.mobile.de/auto-inserat/.../<id>.html or .../details.html?id=<id>).

## `make` (type: `string`):

Optional make name as mobile.de lists it (looked up in mobile.de's own make list on every run). Searches this make; with Models below it is the default make of model names given without one. Example: Volkswagen

## `models` (type: `array`):

Optional 'Make/Model' lines (model or model series, as named on mobile.de; looked up in mobile.de's own model list). Several lines = any of them. Examples: Mercedes-Benz/SLR, BMW/3 Series, Volkswagen/Golf

## `sort` (type: `string`):

mobile.de's own result order.

## `fuelType` (type: `array`):

Only these fuels (any of them). Empty = all.

## `transmission` (type: `array`):

Only these gearboxes (any of them). Empty = all.

## `vehicleType` (type: `array`):

Only these body types (any of them). Empty = all.

## `exteriorColor` (type: `array`):

Only these colours (any of them). Empty = all.

## `condition` (type: `string`):

New or used vehicles only.

## `showDamagedVehicles` (type: `string`):

Include, exclude or show only vehicles with unrepaired damage.

## `sellerType` (type: `string`):

Dealers or private sellers only.

## `vatStatus` (type: `string`):

Only listings with deductible VAT (MwSt. ausweisbar).

## `sellerId` (type: `string`):

Only cars of this seller - mobile.de's seller number (the sellerId column of any of its cars). Alone it lists the dealer's whole stock. Example: 12754808

## `priceMin` (type: `integer`):

Lowest price in EUR. Empty = no minimum. Example: 5000

## `priceMax` (type: `integer`):

Highest price in EUR. Empty = no maximum. Example: 30000

## `registrationDateYearMin` (type: `integer`):

Earliest first-registration year. Example: 2018

## `registrationDateYearMax` (type: `integer`):

Latest first-registration year. Example: 2022

## `mileageKmMin` (type: `integer`):

Lowest mileage in km. Example: 10000

## `mileageKmMax` (type: `integer`):

Highest mileage in km. Example: 100000

## `powerKwMin` (type: `integer`):

Lowest engine power in kW (1 kW = 1.36 PS). Example: 100

## `powerKwMax` (type: `integer`):

Highest engine power in kW. Example: 250

## `location` (type: `string`):

Only vehicles located in this country (mobile.de also lists cars from neighbouring countries).

## `latLong` (type: `string`):

Optional centre point for a radius search, as latitude,longitude. Used with Radius. Example: 52.52,13.405 (Berlin)

## `radiusKm` (type: `integer`):

Radius around the centre point in km (mobile.de's own radius filter). Example: 50

## `customFilters` (type: `array`):

Advanced: extra mobile.de search parameters as name=value, one per line, added to every search (the names used in mobile.de search URLs). Examples: ecol=RED, ft=LPG, c=Van

## `includeKeywords` (type: `array`):

Keep only cars whose title contains at least one of these words (checked by this Actor, case-insensitive). Example: competition

## `excludeKeywords` (type: `array`):

Drop cars whose title contains any of these words (checked by this Actor, case-insensitive). Examples: unfall, export, defekt

## `maxAgeMinutes` (type: `integer`):

Keep only listings created within this many minutes (checked by this Actor on mobile.de's creation time). With sort 'Newest listings first' the search stops at the first page with only older listings. 0 = no limit. Example: 1440 (last 24 hours)

## `descriptionMaxLength` (type: `integer`):

Cut the plain-text description to this many characters (the HTML description is kept whole). 0 = no limit. Example: 500

## `monitoringMode` (type: `boolean`):

Compare with earlier runs of the same State key: every car gets changeType NEW / PRICE_CHANGED (with previousPrice and priceChange) and firstSeenAt; unchanged cars are skipped (and not charged) unless 'Emit unchanged' is on. Use with an Apify schedule.

## `emitUnchanged` (type: `boolean`):

With monitoring mode: also output cars that are unchanged since the last run (changeType UNCHANGED).

## `stateKey` (type: `string`):

Name of the saved monitoring state (a named key-value store mobile-de-monitor-<name> in your account). One name per watched search. Example: golf-gti-berlin

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

Maximum number of cars per search term, search URL or filter search. Result pages are read one after another until this number or the end of the results. mobile.de serves at most 2,000 results per search - turn on 'Get more results' to go further. Example: 100

## `automaticPaging` (type: `boolean`):

Read result page after result page. Off = only the first result page of each search.

## `moreResults` (type: `boolean`):

mobile.de stops every search at 2,000 results. On: a larger search is split into price bands of up to 2,000 results each (using mobile.de's price filter) and every band is read, duplicates removed.

## `includeDetails` (type: `boolean`):

Open every listing for equipment (features), description, all attributes (colour, seats, emission class, HU ...), dealer address / phone / opening hours / rating, finance offer and price-rating thresholds. One extra request per car. Off = the faster search-card data only.

## `reviewLimit` (type: `integer`):

Newest reviews to add per dealer (from the dealer's public mobile.de ratings page, 10 per page; read once per dealer). Needs Include full details. 0 = no reviews. Example: 5

## `language` (type: `string`):

Language of mobile.de's labels in the output (fuel, transmission, attributes, price rating ...).

## `maxConcurrency` (type: `integer`):

Listings opened in parallel for full details (each with its own proxy session). Example: 3

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

mobile.de is a German site; a German residential proxy is the default. The app API used here also answered from other countries in tests.

## Actor input object example

```json
{
  "searchTerms": [
    "Volkswagen Golf GTI"
  ],
  "make": "",
  "sort": "standard",
  "fuelType": [],
  "transmission": [],
  "vehicleType": [],
  "exteriorColor": [],
  "condition": "ANY",
  "showDamagedVehicles": "Any",
  "sellerType": "ANY",
  "vatStatus": "ANY",
  "sellerId": "",
  "location": "Any",
  "latLong": "",
  "customFilters": [],
  "includeKeywords": [],
  "excludeKeywords": [],
  "maxAgeMinutes": 0,
  "descriptionMaxLength": 0,
  "monitoringMode": false,
  "emitUnchanged": false,
  "stateKey": "default",
  "maxItems": 20,
  "automaticPaging": true,
  "moreResults": false,
  "includeDetails": true,
  "reviewLimit": 0,
  "language": "en",
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}
```

# 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 = {
    "searchTerms": [
        "Volkswagen Golf GTI"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "DE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("neuro-scraper/mobile-de-cars-scraper").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 = {
    "searchTerms": ["Volkswagen Golf GTI"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("neuro-scraper/mobile-de-cars-scraper").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 '{
  "searchTerms": [
    "Volkswagen Golf GTI"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}' |
apify call neuro-scraper/mobile-de-cars-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neuro-scraper/mobile-de-cars-scraper"
        }
    }
}
```

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/B5lTge0gOI6paT9e5/builds/lttTojhPTy1eRd3uF/openapi.json
