# mobile.de Listings Scraper (`xtracto/mobilede-listings`) Actor Scrape used-car and vehicle listings from mobile.de — Germany's largest automotive marketplace (~1.9 M active listings). Returns structured JSON with price, specs, features, contact, and images via the internal BFF JSON endpoint. No auth required. - **URL**: https://apify.com/xtracto/mobilede-listings.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.70 / 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/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 ## mobile.de Listings Scraper Extract car and vehicle listings from [mobile.de](https://www.mobile.de) — Germany's largest automotive marketplace with around 1.9 million active listings. ### Why use this actor - **No account or login required** — search and collect listings without signing up. - **Search by any keyword** — find by make, model, trim, or any free-text term (e.g. "volkswagen golf", "bmw 3 series"). - **Filter by price, mileage, and registration year** — narrow results before they hit your dataset. - **Optional deep detail per listing** — toggle one field to also collect full equipment lists, descriptions, and finance information. - **Stable structured JSON output** — every record has the same fields, ready to load into a spreadsheet, database, or pipeline. - **Multiple queries in one run** — supply a list of search terms and get all results in a single dataset. ### How it works 1. You provide one or more search queries (e.g. `["volkswagen golf", "bmw 320d"]`) and optional filters such as max price or mileage. 2. The actor pages through search results and collects up to your chosen limit per query. 3. If **Fetch per-listing detail** is enabled, each listing is enriched with its full equipment list, HTML description, and finance plans. 4. Results stream into your Apify dataset as structured JSON records — no browser, no account, and no API key needed on your end. ### Input ```json { "searchQueries": ["volkswagen golf"], "categoryId": "Car", "maxPrice": 15000, "minPrice": 2000, "maxMileage": 150000, "minFirstRegistrationDate": "2019-01", "maxFirstRegistrationDate": "2023-12", "sortBy": "price_asc", "maxListingsPerQuery": 200, "fetchDetail": false, "concurrency": 3, "proxyConfiguration": { "useApifyProxy": true } } ```` | Field | Type | Description | |---|---|---| | `searchQueries` | string\[] | One or more search terms. Each runs as a separate search. Example: `["volkswagen golf", "bmw 3 series"]`. | | `categoryId` | string | Vehicle category: `Car`, `Truck`, `Motorcycle`, `Van`, `Camper`, `Trailer`, or empty for all. Default: `Car`. | | `maxPrice` | integer | Maximum price in EUR. `0` means no limit. | | `minPrice` | integer | Minimum price in EUR. `0` means no limit. | | `maxMileage` | integer | Maximum odometer reading in km. `0` means no limit. | | `minFirstRegistrationDate` | string | Earliest first registration date, `YYYY-MM` format (e.g. `2019-01`). Leave empty for no lower limit. | | `maxFirstRegistrationDate` | string | Latest first registration date, `YYYY-MM` format (e.g. `2023-12`). Leave empty for no upper limit. | | `sortBy` | string | Sort order: `relevance` (default), `price_asc`, `price_desc`, `mileage_asc`, `age_asc`. | | `maxListingsPerQuery` | integer | Maximum listings to collect per search query. `0` fetches all pages. Default: `200`. | | `fetchDetail` | boolean | Fetch full detail for each listing (equipment list, description, finance). Doubles request count. Default: `true`. | | `concurrency` | integer | Number of parallel requests (1–10). Default: `3`. | | `proxyConfiguration` | object | Apify proxy settings. | ### Output Each record includes envelope fields `_input` (the search query), `_source` (`S1-search` or `S1-detail`), and `_scrapedAt` (UTC timestamp), plus the raw listing data from mobile.de. #### Search record (fetchDetail: false) ```json { "_input": "volkswagen golf", "_source": "S1-search", "_scrapedAt": "2026-06-10T12:13:20Z", "id": 457104037, "url": "https://suchen.mobile.de/auto-inserat/volkswagen-golf-iv-1-4-comfortline-l%C3%BCneburg/457104037.html", "make": { "id": "25200", "localized": "Volkswagen" }, "model": { "id": "14", "localized": "Golf" }, "price": { "grs": { "amount": 100.0, "currency": "EUR", "localized": "100 €" }, "type": "NEGOTIABLE" }, "attr": { "cn": "DE", "z": "21337", "loc": "Lüneburg", "fr": "05/2003", "pw": "55 kW (75 PS)", "ft": "Benzin", "ml": "330.000 km", "cc": "1.390 cm³", "tr": "Schaltgetriebe", "ecol": "Blau", "door": "4/5", "c": "Limousine" }, "contact": { "type": "Privatanbieter", "country": "DE", "enumType": "FSBO" }, "numImages": 3 } ``` #### Detail record (fetchDetail: true) All search fields above, plus: ```json { "_source": "S1-detail", "attributes": [ { "label": "Fahrzeugzustand", "tag": "damageCondition", "value": "Gebrauchtfahrzeug" }, { "label": "Kategorie", "tag": "category", "value": "Limousine" }, { "label": "Kilometerstand", "tag": "mileage", "value": "330.000 km" }, "... 15 more" ], "features": ["ABS", "Armlehne", "Bordcomputer", "Elektr. Fensterheber", "Elektr. Seitenspiegel", "... 13 more"], "htmlDescription": "Verkaufe meinen VW Golf IV ...", "financePlans": null, "leasing": null } ``` | Field | Type | Description | |---|---|---| | `_input` | string | The search query that produced this record. | | `_source` | string | `S1-search` (search result only) or `S1-detail` (enriched with full detail). | | `_scrapedAt` | string | UTC timestamp when this record was collected. | | `id` | integer | Unique listing ID on mobile.de. | | `url` | string | Direct link to the listing page. | | `make` | object | Vehicle make with `id` and localized name. | | `model` | object | Vehicle model with `id` and localized name. | | `price` | object | Price with `amount`, `currency`, and display string. Type: `FIXED`, `NEGOTIABLE`, or `LEASING`. | | `attr` | object | Core attributes: location (`loc`, `z`, `cn`), first registration (`fr`), power (`pw`), fuel type (`ft`), mileage (`ml`), engine size (`cc`), transmission (`tr`), color (`ecol`), body type (`c`). | | `contact` | object | Seller info: type (`Privatanbieter` or dealer), country, lat/lon. | | `numImages` | integer | Number of photos attached to the listing. | | `attributes` | array | Full labelled specification list (detail only). Each item has `label`, `tag`, `value`. | | `features` | array | Equipment and feature list, e.g. `["ABS", "Apple CarPlay", "Sitzheizung"]` (detail only). | | `htmlDescription` | string | Seller's full listing description as HTML (detail only). | | `financePlans` | object/null | Finance offer details if available (detail only). | | `_error` | string | Present only on error records. Describes what went wrong. | ### Other actors in this collection | Actor | What it collects | |---|---| | [Immobiliare Listings](https://apify.com/xtracto/immobiliare-listings) | Italian real estate listings | | [Idealista Listings](https://apify.com/xtracto/idealista-listings) | Spanish real estate listings | | [Leboncoin Listings](https://apify.com/xtracto/leboncoin-listings) | French classifieds | | [Avito Listings](https://apify.com/xtracto/avito-listings) | Russian classifieds | | [MercadoLibre Listings](https://apify.com/xtracto/mercadolibre-listings) | Latin American marketplace | | [Eventbrite Events](https://apify.com/xtracto/eventbrite-events) | Event listings | | [Kickstarter Projects](https://apify.com/xtracto/kickstarter-projects) | Crowdfunding projects | # Actor input Schema ## `searchQueries` (type: `array`): One or more free-text search queries (e.g. 'volkswagen golf', 'bmw 3 series', 'mercedes c class'). Each query is run as a separate search on mobile.de. ## `categoryId` (type: `string`): Filter by vehicle category. 'Car' covers ~95% of listings. Leave empty for all categories. ## `maxPrice` (type: `integer`): Maximum listing price in EUR. Leave 0 for no limit. ## `minPrice` (type: `integer`): Minimum listing price in EUR. Leave 0 for no limit. ## `maxMileage` (type: `integer`): Maximum odometer reading in km. Leave 0 for no limit. ## `minFirstRegistrationDate` (type: `string`): Only include cars first registered on or after this date, e.g. '2019-01'. Leave empty for no lower limit. ## `maxFirstRegistrationDate` (type: `string`): Only include cars first registered on or before this date, e.g. '2023-12'. Leave empty for no upper limit. ## `sortBy` (type: `string`): Sort search results. ## `maxListingsPerQuery` (type: `integer`): Maximum number of listings to extract per search query. 0 = no limit (fetches all pages). Default 200. ## `fetchDetail` (type: `boolean`): If true, fetch full detail for each listing to get attributes\[], features\[], images\[], and htmlDescription. Doubles the number of requests. Default true. ## `concurrency` (type: `integer`): Max concurrent HTTP requests. Recommended: 3-5. Higher values risk rate-limiting. ## `proxyConfiguration` (type: `object`): Apify proxy settings. Datacenter proxies work well. For large-scale runs, DE residential proxies are recommended. ## Actor input object example ```json { "searchQueries": [ "volkswagen golf" ], "categoryId": "Car", "maxPrice": 0, "minPrice": 0, "maxMileage": 0, "minFirstRegistrationDate": "2019-01", "maxFirstRegistrationDate": "2023-12", "sortBy": "relevance", "maxListingsPerQuery": 200, "fetchDetail": true, "concurrency": 3, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "volkswagen golf" ], "minFirstRegistrationDate": "2019-01", "maxFirstRegistrationDate": "2023-12" }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/mobilede-listings").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["volkswagen golf"], "minFirstRegistrationDate": "2019-01", "maxFirstRegistrationDate": "2023-12", } # Run the Actor and wait for it to finish run = client.actor("xtracto/mobilede-listings").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 '{ "searchQueries": [ "volkswagen golf" ], "minFirstRegistrationDate": "2019-01", "maxFirstRegistrationDate": "2023-12" }' | apify call xtracto/mobilede-listings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/mobilede-listings", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "mobile.de Listings Scraper", "description": "Scrape used-car and vehicle listings from mobile.de — Germany's largest automotive marketplace (~1.9 M active listings). Returns structured JSON with price, specs, features, contact, and images via the internal BFF JSON endpoint. No auth required.", "version": "0.1", "x-build-id": "FYOdoWNFSgvdC8Yja" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~mobilede-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-mobilede-listings", "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/xtracto~mobilede-listings/runs": { "post": { "operationId": "runs-sync-xtracto-mobilede-listings", "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/xtracto~mobilede-listings/run-sync": { "post": { "operationId": "run-sync-xtracto-mobilede-listings", "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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more free-text search queries (e.g. 'volkswagen golf', 'bmw 3 series', 'mercedes c class'). Each query is run as a separate search on mobile.de.", "items": { "type": "string" } }, "categoryId": { "title": "Vehicle category", "enum": [ "Car", "Truck", "Motorcycle", "Van", "Camper", "Trailer", "" ], "type": "string", "description": "Filter by vehicle category. 'Car' covers ~95% of listings. Leave empty for all categories.", "default": "Car" }, "maxPrice": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Maximum listing price in EUR. Leave 0 for no limit.", "default": 0 }, "minPrice": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Minimum listing price in EUR. Leave 0 for no limit.", "default": 0 }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in km. Leave 0 for no limit.", "default": 0 }, "minFirstRegistrationDate": { "title": "Earliest first registration (YYYY-MM)", "pattern": "^(\\d{4}-\\d{2})?$", "type": "string", "description": "Only include cars first registered on or after this date, e.g. '2019-01'. Leave empty for no lower limit.", "default": "" }, "maxFirstRegistrationDate": { "title": "Latest first registration (YYYY-MM)", "pattern": "^(\\d{4}-\\d{2})?$", "type": "string", "description": "Only include cars first registered on or before this date, e.g. '2023-12'. Leave empty for no upper limit.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "mileage_asc", "age_asc" ], "type": "string", "description": "Sort search results.", "default": "relevance" }, "maxListingsPerQuery": { "title": "Max listings per query", "minimum": 0, "type": "integer", "description": "Maximum number of listings to extract per search query. 0 = no limit (fetches all pages). Default 200.", "default": 200 }, "fetchDetail": { "title": "Fetch per-listing detail", "type": "boolean", "description": "If true, fetch full detail for each listing to get attributes[], features[], images[], and htmlDescription. Doubles the number of requests. Default true.", "default": true }, "concurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Max concurrent HTTP requests. Recommended: 3-5. Higher values risk rate-limiting.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Datacenter proxies work well. For large-scale runs, DE residential proxies are recommended.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```