# Mobile.de Discovery — Germany Vehicle Search (`rastriq/mobilede-discovery`) Actor

Discover and extract vehicle search results from Mobile.de at scale. Covers cars, commercial vehicles, motorcycles, and motorhomes. Extract listing URLs, prices, key specs, and dealer info from search results pages. Use as a discovery layer before deep scraping.

- **URL**: https://apify.com/rastriq/mobilede-discovery.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.90 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### What data can you scrape from Mobile.de — Germany Vehicle Search?

Extract structured data from Mobile.de — Germany Vehicle Search including listings, prices, and details.

- **Structured output** — Clean, normalized records ready for spreadsheets, BI tools or databases
- **Flexible filters** — Narrow your scrape by category, keyword, or other parameters
- **Export anywhere** — JSON, CSV, Excel, or via the Apify API and integrations

---

### Output: Mobile.de — Germany Vehicle Search data structure

| Field | Label | Format |
|-------|-------|--------|
| `url` | Url | link |
| `marca` | Marca | text |
| `modelo` | Modelo | text |
| `anio` | Anio | number |
| `valor` | Valor | number |
| `moneda` | Moneda | text |
| `estado` | Estado | text |
| `categoria` | Categoria | text |
| `ubicacion` | Ubicacion | text |
| `pais` | Pais | text |
| `compania` | Compania | text |
| `tiempo_uso` | Tiempo Uso | number |
| `fecha_publicacion` | Fecha Publicacion | date |
| `item_id` | Item Id | text |
| `source` | Source | text |

---

### 🚀 Quick start

1. Click **Start** with the default input to test with a small sample.
2. Open the **Output** tab to preview results.
3. Export as CSV / Excel / JSON, or connect via API.

---

### How to scrape Mobile.de — Germany Vehicle Search — input options

| Field | Description | Default |
|-------|-------------|---------|
| **🎯 Market coverage** | Controls how many search slices the scraper visits.• **Full market** — crawls all 68 internal slices (~30,600 listing... | `full_market` |
| **📊 Data depth** | How much data to extract per listing.• **Summary only** — ~14 fields from search cards (title, price, year, hours, lo... | `summary_only` |
| **Max listings** | Global limit on total listings to extract. 0 = no limit.Use **50–100** for test runs, **0** for full market. | `0` |
| **🏗️ Construction Machines (Baumaschinen)** | Excavators, loaders, cranes, dozers, rollers… · ~11,500 listings | true |
| **🚜 Agricultural Vehicles (Agrar)** | Tractors, harvesters, seeders, ploughs, mulchers… · ~11,200 listings | true |
| **📦 Forklifts (Stapler)** | Front forklifts, telescopic, reach trucks, low lift… · ~7,900 listings | true |
| **Construction Machine subtype** | Filter construction machines by equipment type. **All** = no filter. | `all` |
| **Agricultural Vehicle subtype** | Filter agricultural vehicles by equipment type. **All** = no filter. | `all` |
| **Forklift subtype** | Filter forklifts by equipment type. **All** = no filter. | `all` |
| **Condition** | Filter by new or used equipment. | `all` |
| **Year filter** | Enable year range filtering. | `all` |
| **Year from** | Minimum manufacture year (inclusive). Only active when year filter = range. | — |
| **Year to** | Maximum manufacture year (inclusive). Only active when year filter = range. | — |
| **Detail strategy** | When extracting detail pages, should the scraper visit **every** listing or only those where the search card is missi... | `missing_only` |
| **Include image URLs** | Extract image URLs from each listing. | true |
| **Include seller contacts** | Extract seller phone and email. Full phone numbers require Summary + detail mode. | false |
| **Max pages per slice** | Pages of results per internal slice. Each page has about 20 listings. Use 1 for quick test, 50 for full coverage. | `50` |
| **Proxy configuration** | Optional. Residential proxies recommended for best results. | Apify auto |
| **Debug mode** | Adds diagnostic fields to output. Not recommended for production. | false |
| **Vehicle categories (API)** | Legacy array field for API backward compatibility. | `[]` |
| **Subtypes (API)** | Legacy array field for API backward compatibility. | `[]` |

---

### 🔍 How it works

This Actor uses **Playwright (headless browser)** to extract data from Mobile.de — Germany Vehicle Search. It navigates search results or catalog pages, extracts structured data from each listing, and normalizes the output into a consistent schema.

---

### How much does it cost to scrape Mobile.de — Germany Vehicle Search?

This Actor uses **Pay-Per-Event** pricing — you pay only for results delivered, not for compute time.

| Plan | What you get |
|------|-------------|
| **Free tier** | $5/month of platform credits — enough for thousands of results |
| **Paid plans** | Scale to tens of thousands of results per run |

---

### 🔄 Integrations & scheduling

- **Schedule** daily/weekly runs from the Apify Console for automated data collection.
- Push results to **Google Sheets, Slack, Zapier, Make, webhooks** or any database.
- Fetch datasets via the **Apify REST API** or the official JavaScript/Python clients.

---

### Is it legal to scrape Mobile.de — Germany Vehicle Search?

This Actor collects only **publicly available** data. It does not log in, bypass paywalls, or access private information. You are responsible for using the extracted data in compliance with the site's Terms of Service and applicable data protection laws (including GDPR where relevant).

---

### ❓ FAQ

**Can I access the data via API?**
Yes. Every run stores its dataset on Apify. Fetch it via REST API or use the official JavaScript/Python clients.

**What export formats are supported?**
JSON, CSV, Excel (XLSX), XML, and HTML table. You can also push data directly to Google Sheets or any webhook endpoint.

**Do I need proxies?**
Residential proxies are recommended for best results. The default proxy configuration is pre-set.

### Related Actors from Rastriq

- [Wallapop Cars Scraper](https://apify.com/rastriq/wallapop-cars-scraper)
- [Cochesnet Spain Scraper](https://apify.com/rastriq/cochesnet-spain)
- [Autoscout24 Scraper](https://apify.com/rastriq/autoscout24-scraper)
- [Mobile De Scraper](https://apify.com/rastriq/mobile-de-scraper)

# Actor input Schema

## `coverageMode` (type: `string`):

Controls how many search slices the scraper visits.<br><br>• <b>Full market</b> — crawls all 68 internal slices (~30,600 listings). Best for complete census runs.<br>• <b>Custom filters</b> — apply category, condition, subtype and year filters below. Best for focused analysis or quick tests.
## `dataDepth` (type: `string`):

How much data to extract per listing.<br><br>• <b>Summary only</b> — ~14 fields from search cards (title, price, year, hours, location, seller). Fast and cheap.<br>• <b>Summary + detail</b> — also visits detail pages for premium fields (phone, serial number, specs). Slower, higher cost.
## `maxItems` (type: `integer`):

Global limit on total listings to extract. <code>0</code> = no limit.<br>Use <b>50–100</b> for test runs, <b>0</b> for full market.
## `catConstructionMachine` (type: `boolean`):

Excavators, loaders, cranes, dozers, rollers… · ~11,500 listings
## `catAgriculturalVehicle` (type: `boolean`):

Tractors, harvesters, seeders, ploughs, mulchers… · ~11,200 listings
## `catForkliftTruck` (type: `boolean`):

Front forklifts, telescopic, reach trucks, low lift… · ~7,900 listings
## `constructionSubtype` (type: `string`):

Filter construction machines by equipment type. <b>All</b> = no filter.
## `agriculturalSubtype` (type: `string`):

Filter agricultural vehicles by equipment type. <b>All</b> = no filter.
## `forkliftSubtype` (type: `string`):

Filter forklifts by equipment type. <b>All</b> = no filter.
## `condition` (type: `string`):

Filter by new or used equipment.
## `yearMode` (type: `string`):

Enable year range filtering.
## `yearFrom` (type: `integer`):

Minimum manufacture year (inclusive). Only active when year filter = range.
## `yearTo` (type: `integer`):

Maximum manufacture year (inclusive). Only active when year filter = range.
## `detailStrategy` (type: `string`):

When extracting detail pages, should the scraper visit <b>every</b> listing or only those where the search card is missing key fields (price, year, hours)?<br><br>• <b>Missing only</b> — skips detail pages when the search card already has all key fields. Saves time and proxy cost.<br>• <b>All items</b> — visits every detail page regardless. Gets the most complete data but takes longer.
## `includeImages` (type: `boolean`):

Extract image URLs from each listing.
## `includeSellerContacts` (type: `boolean`):

Extract seller phone and email. Full phone numbers require Summary + detail mode.
## `maxPagesPerSlice` (type: `integer`):

Pages of results per internal slice. Each page has about 20 listings. Use 1 for quick test, 50 for full coverage.
## `proxyConfiguration` (type: `object`):

A German residential proxy is mandatory. Datacenter IPs are blocked.
## `debugMode` (type: `boolean`):

Adds diagnostic fields to output. Not recommended for production.
## `vehicleCategories` (type: `array`):

Legacy array field for API backward compatibility.
## `subtypes` (type: `array`):

Legacy array field for API backward compatibility.

## Actor input object example

```json
{
  "coverageMode": "custom_filters",
  "dataDepth": "summary_only",
  "maxItems": 50,
  "catConstructionMachine": true,
  "catAgriculturalVehicle": true,
  "catForkliftTruck": true,
  "constructionSubtype": "all",
  "agriculturalSubtype": "all",
  "forkliftSubtype": "all",
  "condition": "all",
  "yearMode": "all",
  "detailStrategy": "missing_only",
  "includeImages": true,
  "includeSellerContacts": false,
  "maxPagesPerSlice": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  },
  "debugMode": false,
  "vehicleCategories": [],
  "subtypes": []
}
````

# Actor output Schema

## `_card_text_len` (type: `string`):

card text len

## `_card_title` (type: `string`):

card title

## `anio` (type: `string`):

Anio

## `carga` (type: `string`):

Carga

## `categoria` (type: `string`):

Categoria

## `compania` (type: `string`):

Compania

## `correo` (type: `string`):

Correo

## `data_level` (type: `string`):

Data level

## `estado` (type: `string`):

Estado

## `fabric_motor` (type: `string`):

Fabric motor

## `fec_entrega` (type: `string`):

Fec entrega

## `fecha_publicacion` (type: `string`):

Fecha publicacion

## `imagenes` (type: `string`):

Imagenes

## `item_id` (type: `string`):

Item id

## `marca` (type: `string`):

Marca

## `modelo` (type: `string`):

Modelo

## `moneda` (type: `string`):

Moneda

## `num_serie` (type: `string`):

Num serie

## `pais` (type: `string`):

Pais

## `pais_fab` (type: `string`):

Pais fab

## `peso` (type: `string`):

Peso

## `pot_motor` (type: `string`):

Pot motor

## `ref_anunciante` (type: `string`):

Ref anunciante

## `ref_anuncio` (type: `string`):

Ref anuncio

## `renta_dia` (type: `string`):

Renta dia

## `slice_category` (type: `string`):

Slice category

## `slice_label` (type: `string`):

Slice label

## `snapshot_at` (type: `string`):

Snapshot at

## `source` (type: `string`):

Source

## `telefono` (type: `string`):

Telefono

## `tiempo_uso` (type: `string`):

Tiempo uso

## `tipo` (type: `string`):

Tipo

## `tipo_motor` (type: `string`):

Tipo motor

## `ubicacion` (type: `string`):

Ubicacion

## `url` (type: `string`):

Url

## `valor` (type: `string`):

Valor

# 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 = {
    "coverageMode": "custom_filters",
    "dataDepth": "summary_only",
    "maxItems": 50,
    "catForkliftTruck": true,
    "maxPagesPerSlice": 1,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "DE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/mobilede-discovery").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 = {
    "coverageMode": "custom_filters",
    "dataDepth": "summary_only",
    "maxItems": 50,
    "catForkliftTruck": True,
    "maxPagesPerSlice": 1,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "DE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/mobilede-discovery").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "coverageMode": "custom_filters",
  "dataDepth": "summary_only",
  "maxItems": 50,
  "catForkliftTruck": true,
  "maxPagesPerSlice": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "DE"
  }
}' |
apify call rastriq/mobilede-discovery --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=rastriq/mobilede-discovery",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Mobile.de Discovery — Germany Vehicle Search",
        "description": "Discover and extract vehicle search results from Mobile.de at scale. Covers cars, commercial vehicles, motorcycles, and motorhomes. Extract listing URLs, prices, key specs, and dealer info from search results pages. Use as a discovery layer before deep scraping.",
        "version": "0.7",
        "x-build-id": "DBE8zXkSE1NO1j6FQ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/rastriq~mobilede-discovery/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-rastriq-mobilede-discovery",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/rastriq~mobilede-discovery/runs": {
            "post": {
                "operationId": "runs-sync-rastriq-mobilede-discovery",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/rastriq~mobilede-discovery/run-sync": {
            "post": {
                "operationId": "run-sync-rastriq-mobilede-discovery",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "coverageMode",
                    "dataDepth"
                ],
                "properties": {
                    "coverageMode": {
                        "title": "🎯 Market coverage",
                        "enum": [
                            "full_market",
                            "custom_filters"
                        ],
                        "type": "string",
                        "description": "Controls how many search slices the scraper visits.<br><br>• <b>Full market</b> — crawls all 68 internal slices (~30,600 listings). Best for complete census runs.<br>• <b>Custom filters</b> — apply category, condition, subtype and year filters below. Best for focused analysis or quick tests.",
                        "default": "full_market"
                    },
                    "dataDepth": {
                        "title": "📊 Data depth",
                        "enum": [
                            "summary_only",
                            "summary_plus_detail"
                        ],
                        "type": "string",
                        "description": "How much data to extract per listing.<br><br>• <b>Summary only</b> — ~14 fields from search cards (title, price, year, hours, location, seller). Fast and cheap.<br>• <b>Summary + detail</b> — also visits detail pages for premium fields (phone, serial number, specs). Slower, higher cost.",
                        "default": "summary_only"
                    },
                    "maxItems": {
                        "title": "Max listings",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Global limit on total listings to extract. <code>0</code> = no limit.<br>Use <b>50–100</b> for test runs, <b>0</b> for full market.",
                        "default": 0
                    },
                    "catConstructionMachine": {
                        "title": "🏗️ Construction Machines (Baumaschinen)",
                        "type": "boolean",
                        "description": "Excavators, loaders, cranes, dozers, rollers… · ~11,500 listings",
                        "default": true
                    },
                    "catAgriculturalVehicle": {
                        "title": "🚜 Agricultural Vehicles (Agrar)",
                        "type": "boolean",
                        "description": "Tractors, harvesters, seeders, ploughs, mulchers… · ~11,200 listings",
                        "default": true
                    },
                    "catForkliftTruck": {
                        "title": "📦 Forklifts (Stapler)",
                        "type": "boolean",
                        "description": "Front forklifts, telescopic, reach trucks, low lift… · ~7,900 listings",
                        "default": true
                    },
                    "constructionSubtype": {
                        "title": "Construction Machine subtype",
                        "enum": [
                            "all",
                            "WheeledLoader",
                            "MiniDigger",
                            "CaterpillarDigger",
                            "MobileDigger",
                            "OtherConstructionMachine",
                            "WorkingPlatform",
                            "ConstructionMachine_OtherSubstructure",
                            "ConstructionEquipment",
                            "Roller",
                            "ConstructionCrane",
                            "RoadBuildingTechnology",
                            "Dozer",
                            "CompactionTechnology",
                            "CombinedDredgerLoader",
                            "Grader",
                            "DrillMachine",
                            "SoilStabiliser"
                        ],
                        "type": "string",
                        "description": "Filter construction machines by equipment type. <b>All</b> = no filter.",
                        "default": "all"
                    },
                    "agriculturalSubtype": {
                        "title": "Agricultural Vehicle subtype",
                        "enum": [
                            "all",
                            "FarmyardTractor",
                            "HarrowingEquipment",
                            "HarvestingMachine",
                            "HaymakingEquipment",
                            "OtherSubstructure",
                            "Tractor",
                            "Reaper",
                            "Seeder",
                            "FertilizerSpreader",
                            "LoaderWagon",
                            "CombineHarvester",
                            "Mulcher",
                            "Plough",
                            "ForestryVehicle",
                            "PlantProtection",
                            "FrontEndLoader",
                            "OtherAgriculturalVehicle",
                            "OrchardEquipment"
                        ],
                        "type": "string",
                        "description": "Filter agricultural vehicles by equipment type. <b>All</b> = no filter.",
                        "default": "all"
                    },
                    "forkliftSubtype": {
                        "title": "Forklift subtype",
                        "enum": [
                            "all",
                            "FrontMountedForkliftTruck",
                            "HighLiftTruck",
                            "TelescopicForkliftTruck",
                            "LowLiftTruck",
                            "OtherForkliftTruck",
                            "ReachForkliftTruck",
                            "SideLoadingForkliftTruck",
                            "RoughTerrainForkliftTruck",
                            "ContainerForkliftTruck",
                            "HighBayRackForkliftTruck"
                        ],
                        "type": "string",
                        "description": "Filter forklifts by equipment type. <b>All</b> = no filter.",
                        "default": "all"
                    },
                    "condition": {
                        "title": "Condition",
                        "enum": [
                            "all",
                            "new",
                            "used"
                        ],
                        "type": "string",
                        "description": "Filter by new or used equipment.",
                        "default": "all"
                    },
                    "yearMode": {
                        "title": "Year filter",
                        "enum": [
                            "all",
                            "range"
                        ],
                        "type": "string",
                        "description": "Enable year range filtering.",
                        "default": "all"
                    },
                    "yearFrom": {
                        "title": "Year from",
                        "minimum": 1950,
                        "maximum": 2030,
                        "type": "integer",
                        "description": "Minimum manufacture year (inclusive). Only active when year filter = range."
                    },
                    "yearTo": {
                        "title": "Year to",
                        "minimum": 1950,
                        "maximum": 2030,
                        "type": "integer",
                        "description": "Maximum manufacture year (inclusive). Only active when year filter = range."
                    },
                    "detailStrategy": {
                        "title": "Detail strategy",
                        "enum": [
                            "missing_only",
                            "all_items"
                        ],
                        "type": "string",
                        "description": "When extracting detail pages, should the scraper visit <b>every</b> listing or only those where the search card is missing key fields (price, year, hours)?<br><br>• <b>Missing only</b> — skips detail pages when the search card already has all key fields. Saves time and proxy cost.<br>• <b>All items</b> — visits every detail page regardless. Gets the most complete data but takes longer.",
                        "default": "missing_only"
                    },
                    "includeImages": {
                        "title": "Include image URLs",
                        "type": "boolean",
                        "description": "Extract image URLs from each listing.",
                        "default": true
                    },
                    "includeSellerContacts": {
                        "title": "Include seller contacts",
                        "type": "boolean",
                        "description": "Extract seller phone and email. Full phone numbers require Summary + detail mode.",
                        "default": false
                    },
                    "maxPagesPerSlice": {
                        "title": "Max pages per slice",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Pages of results per internal slice. Each page has about 20 listings. Use 1 for quick test, 50 for full coverage.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "A German residential proxy is mandatory. Datacenter IPs are blocked."
                    },
                    "debugMode": {
                        "title": "Debug mode",
                        "type": "boolean",
                        "description": "Adds diagnostic fields to output. Not recommended for production.",
                        "default": false
                    },
                    "vehicleCategories": {
                        "title": "Vehicle categories (API)",
                        "type": "array",
                        "description": "Legacy array field for API backward compatibility.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "subtypes": {
                        "title": "Subtypes (API)",
                        "type": "array",
                        "description": "Legacy array field for API backward compatibility.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
