# Mobile.de dealer car listings

Vehicle listings from dealers on mobile.de, Germany's largest car marketplace, each with make, model, price and net price, mileage, first registration, power. Takes query, make, model and more, all optional. Served by Apify.

Vehicle listings from dealers on mobile.de, Germany's largest car marketplace, each with make, model, price and net price, mileage, first registration, power, fuel, gearbox, condition, accident status, equipment, mobile.de's price rating and the dealer's name, rating, address, phone and website. Search by make, model and filters (e.g. 'BMW' '3er' under 30000 EUR) or pass mobile.de search URLs. Price: up to $0.00059 per listing, plus up to $0.005 per run. Billed at the run's actual cost, never more than max_cost_usd (default $0.1), which is enforced upstream as the run's charge limit. Returns { run, items } when the run ends within 40 s, otherwise a run id: fetch the items with apify/run-results (free, tool "mobile-de-dealer-cars"). A run that times out or reaches the limit returns and bills its partial items.

- Tool ID: `apify/mobile-de-dealer-cars`
- Provider: [Apify](/providers/apify.md)
- Capability: [E-commerce](/tools/ecommerce.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the cost the provider reports for the call, never above $1. Your agent sees the maximum before running.


```json
{
  "model": "reported",
  "costPath": "data.usageTotalUsd",
  "requireCost": true,
  "maxUsdField": "max_cost_usd",
  "maxUsdDefault": 0.1,
  "maxUsdCap": 1,
  "headroom": 1
}
```

Pricing source: [https://apify.com/blackfalcondata/mobile-de-scraper/pricing](https://apify.com/blackfalcondata/mobile-de-scraper/pricing). Pay-per-event rate card of blackfalcondata/mobile-de-scraper, read from the public Apify API (api.apify.com/v2/acts/blackfalcondata~mobile-de-scraper): every event and tier price, the pricing model, who pays platform usage and the minimal charge limit..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Free-text keywords, e.g. 'VW Golf GTI'"
    },
    "make": {
      "type": "string",
      "maxLength": 50,
      "description": "Make, e.g. 'BMW' or 'Mercedes-Benz'"
    },
    "model": {
      "type": "string",
      "maxLength": 80,
      "description": "Model, needs make, e.g. 'Golf'"
    },
    "category": {
      "type": "string",
      "enum": [
        "CAR",
        "MOTORBIKE",
        "MOTORHOME",
        "VAN",
        "TRUCK_UP_TO_7500",
        "TRUCK_OVER_7500",
        "BUS",
        "TRAILER"
      ],
      "default": "CAR",
      "description": "Vehicle type, e.g. 'MOTORHOME'"
    },
    "startUrls": {
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "string",
        "pattern": "^https://(suchen\\.|www\\.)?mobile\\.de/"
      },
      "description": "Instead of fields: mobile.de search or listing URLs, e.g. ['https://suchen.mobile.de/fahrzeuge/search.html?ms=3500%3B20']"
    },
    "sellerId": {
      "type": "string",
      "pattern": "^\\d{3,12}$",
      "description": "Only one dealer's stock, by mobile.de dealer id, e.g. '7938968'"
    },
    "condition": {
      "type": "array",
      "maxItems": 6,
      "items": {
        "type": "string",
        "enum": [
          "NEW",
          "USED",
          "EMPLOYEE_CAR",
          "PRE_REGISTRATION",
          "DEMONSTRATION",
          "CLASSIC"
        ]
      },
      "description": "Conditions to keep, e.g. ['USED']"
    },
    "fuelType": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "enum": [
          "DIESEL",
          "PETROL",
          "ELECTRIC",
          "HYBRID",
          "PLUG_IN_HYBRID",
          "HYBRID_DIESEL",
          "CNG",
          "LPG",
          "HYDROGEN",
          "ETHANOL"
        ]
      },
      "description": "Fuels to keep, e.g. ['ELECTRIC']"
    },
    "transmission": {
      "type": "array",
      "maxItems": 3,
      "items": {
        "type": "string",
        "enum": [
          "MANUAL_GEAR",
          "AUTOMATIC_GEAR",
          "SEMI_AUTOMATIC_GEAR"
        ]
      },
      "description": "Gearboxes to keep, e.g. ['AUTOMATIC_GEAR']"
    },
    "priceMin": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Minimum price in EUR, e.g. 10000"
    },
    "priceMax": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Maximum price in EUR, e.g. 30000"
    },
    "mileageMax": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2000000,
      "description": "Maximum mileage in km, e.g. 80000"
    },
    "yearMin": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2030,
      "description": "Earliest first registration year, e.g. 2019"
    },
    "yearMax": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2030,
      "description": "Latest first registration year, e.g. 2023"
    },
    "zipCode": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "German postal code to search around, e.g. '80331'"
    },
    "radiusKm": {
      "type": "integer",
      "minimum": 0,
      "maximum": 500,
      "description": "Radius around the postal code in km, e.g. 50"
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "mileage_asc",
        "mileage_desc",
        "registration_desc",
        "registration_asc",
        "newest",
        "oldest"
      ],
      "default": "relevance",
      "description": "Order of the results, e.g. 'price_asc'"
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 20,
      "description": "Listings to return, 1 to 200 (each is billed), e.g. 20"
    },
    "max_cost_usd": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 1,
      "default": 0.1,
      "description": "Charge limit for this run in USD, reserved from your balance and enforced upstream as the run's charge limit (default $0.1, at most $1). The run stops charging there."
    }
  },
  "required": [],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "apify/mobile-de-dealer-cars",
  "input": {
    "make": "Volkswagen",
    "model": "Golf",
    "maxResults": 2,
    "max_cost_usd": 0.05
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

This tool uses deferred settlement. Follow its returned task/run instructions; preserve the existing reservation until the result is reconciled.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[REST inspection](https://api.agentik.cc/v1/tools/apify/mobile-de-dealer-cars) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/apify/mobile-de-dealer-cars) · [Agent index](/llms.txt)
