{ "openapi": "3.0.1", "info": { "title": "Mobile De Vehicle Scraper", "description": "Scrape vehicle listings from mobile.de, Germany's largest online car marketplace. Filter by make, model, price, mileage, year, fuel type, transmission, and many more options. Extract comprehensive vehicle data including specifications, pricing, dealer information, and images.", "version": "1.0", "x-build-id": "ZzNWvIw7O0OaXkGRn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~mobile-de-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-mobile-de-vehicle-scraper", "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/crawlerbros~mobile-de-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-mobile-de-vehicle-scraper", "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/crawlerbros~mobile-de-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-mobile-de-vehicle-scraper", "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", "properties": { "searchUrl": { "title": "Search URL (Optional)", "type": "string", "description": "Direct URL from mobile.de search results page. If provided, all other filters will be ignored. Example: https://suchen.mobile.de/fahrzeuge/search.html?dam=0&isSearchRequest=true&ms=3500" }, "make": { "title": "Make (Brand)", "type": "string", "description": "Car manufacturer/brand name (e.g., 'BMW', 'Mercedes-Benz', 'Volkswagen', 'Audi')" }, "model": { "title": "Model", "type": "string", "description": "Car model name (e.g., '3 Series', 'C-Class', 'Golf'). Make must be specified." }, "priceFrom": { "title": "Price From (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in EUR" }, "priceTo": { "title": "Price To (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in EUR" }, "mileageFrom": { "title": "Mileage From (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage in kilometers" }, "mileageTo": { "title": "Mileage To (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometers" }, "yearFrom": { "title": "First Registration From (Year)", "minimum": 1900, "maximum": 2026, "type": "integer", "description": "Minimum first registration year" }, "yearTo": { "title": "First Registration To (Year)", "minimum": 1900, "maximum": 2026, "type": "integer", "description": "Maximum first registration year" }, "fuelType": { "title": "Fuel Type", "type": "array", "description": "Filter by fuel type(s). Options: PETROL, DIESEL, ELECTRIC, HYBRID, HYBRID_PLUGIN, LPG, CNG, HYDROGEN, ETHANOL", "items": { "type": "string" } }, "transmission": { "title": "Transmission", "type": "array", "description": "Filter by transmission type(s). Options: AUTOMATIC_GEAR, MANUAL_GEAR, SEMIAUTOMATIC_GEAR", "items": { "type": "string" } }, "condition": { "title": "Vehicle Condition", "enum": [ "", "NEW", "USED", "EMPLOYEE_CAR", "PRE_REGISTRATION", "DEMONSTRATION", "CLASSIC" ], "type": "string", "description": "Filter by vehicle condition" }, "bodyType": { "title": "Body Type", "type": "array", "description": "Filter by body type(s). Options: Cabrio, EstateCar, Limousine, OffRoad, SmallCar, SportsCar, Van, Other", "items": { "type": "string" } }, "powerFrom": { "title": "Power From (kW)", "minimum": 0, "type": "integer", "description": "Minimum power in kW" }, "powerTo": { "title": "Power To (kW)", "minimum": 0, "type": "integer", "description": "Maximum power in kW" }, "sellerType": { "title": "Seller Type", "enum": [ "", "DEALER", "PRIVATE" ], "type": "string", "description": "Filter by seller type" }, "exteriorColor": { "title": "Exterior Color", "type": "array", "description": "Filter by exterior color(s). Options: BLACK, WHITE, SILVER, GREY, BLUE, RED, GREEN, BROWN, BEIGE, GOLD, ORANGE, YELLOW, VIOLET", "items": { "type": "string" } }, "doors": { "title": "Number of Doors", "enum": [ "", "TWO_OR_THREE", "FOUR_OR_FIVE", "SIX_OR_MORE" ], "type": "string", "description": "Filter by number of doors" }, "seatsFrom": { "title": "Seats From", "minimum": 1, "maximum": 9, "type": "integer", "description": "Minimum number of seats" }, "seatsTo": { "title": "Seats To", "minimum": 1, "maximum": 9, "type": "integer", "description": "Maximum number of seats" }, "driveType": { "title": "Drive Type", "enum": [ "", "FRONT", "REAR", "ALL_WHEEL" ], "type": "string", "description": "Filter by drive type" }, "emissionClass": { "title": "Emission Class", "enum": [ "", "EURO1", "EURO2", "EURO3", "EURO4", "EURO5", "EURO6", "EURO6C", "EURO6D", "EURO6D_TEMP" ], "type": "string", "description": "Filter by emission class" }, "country": { "title": "Country", "enum": [ "", "DE", "AT", "CH", "NL", "BE", "FR", "IT", "ES", "PL" ], "type": "string", "description": "Filter by country (ISO 3166-1 alpha-2 code)", "default": "" }, "zipCode": { "title": "ZIP/Postal Code", "type": "string", "description": "Search around a specific ZIP code" }, "radius": { "title": "Search Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius in kilometers from ZIP code. Common values: 10, 20, 30, 50, 75, 100, 150, 200. Use 0 for Germany-wide search.", "default": 0 }, "includeDamaged": { "title": "Include Damaged Vehicles", "type": "boolean", "description": "Include vehicles with unrepaired damage", "default": false }, "vatDeductible": { "title": "VAT Deductible", "type": "boolean", "description": "Only show vehicles where VAT is deductible (for businesses)", "default": false }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of vehicle listings to scrape", "default": 100 }, "sortBy": { "title": "Sort By", "enum": [ "standard", "price-asc", "price-desc", "mileage-asc", "mileage-desc", "registration-desc", "registration-asc", "power-desc", "power-asc" ], "type": "string", "description": "Sort order for results", "default": "standard" }, "scrapeDetails": { "title": "Scrape Full Details", "type": "boolean", "description": "Visit each vehicle page to scrape complete details including full description, all images, and dealer contact info. This is slower but provides more data.", "default": false }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Use Apify residential proxy (recommended for avoiding bot detection). Requires Apify platform with proxy subscription.", "default": 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 } } } } } } } } } }