{ "openapi": "3.0.1", "info": { "title": "Mobile.de Vehicle Scraper & Automotive Intelligence", "description": "Scrape Mobile.de car listings, prices, technical specifications, dealer ratings, EV battery health, and commercial vehicle data across Europe with advanced filters and AI natural language search.", "version": "1.0", "x-build-id": "Qo1Ya6mtg4cVZ0MCv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dev00~mobilede-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dev00-mobilede-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/dev00~mobilede-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-dev00-mobilede-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/dev00~mobilede-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-dev00-mobilede-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": { "action": { "title": "Scraper Action / Mode", "enum": [ "search", "get_brands", "get_models" ], "type": "string", "description": "Choose between searching vehicle classified listings, extracting all available vehicle brands, or extracting all model names for a brand.", "default": "search" }, "brand": { "title": "Vehicle Brand / Manufacturer Name", "type": "string", "description": "Enter any brand name (e.g. 'Porsche', 'BMW', 'Mercedes-Benz', 'Audi', 'Tesla', 'Volkswagen', 'Ferrari', 'Lamborghini', 'Toyota', 'Ford', 'Ducati', 'MAN', 'John Deere') or numeric make ID." }, "model": { "title": "Model Name or Model ID", "type": "string", "description": "Enter any model name (e.g. '911', 'Taycan', 'Cayenne', '320', 'M3', 'M5', 'Golf', 'Model Y', 'e-tron GT', 'Mustang') or numeric model ID." }, "searchPrompt": { "title": "AI Natural Language Search Prompt", "type": "string", "description": "Conversational query (e.g. 'Electric SUV under 35000 euro with panoramic roof in Munich'). Automatically overrides and fills filters." }, "vehicleClass": { "title": "Vehicle Category / Class", "enum": [ "Car", "Motorbike", "EBike", "Motorhome", "TruckOver7500", "VanUpTo7500", "AgriculturalVehicle", "ConstructionMachine", "ForkliftTruck" ], "type": "string", "description": "Select the vehicle category.", "default": "Car" }, "page": { "title": "Starting Page Number", "minimum": 1, "type": "integer", "description": "Page number to start scraping from (e.g. 1, 2, 3...).", "default": 1 }, "maxPages": { "title": "Maximum Pages to Scrape", "minimum": 1, "maximum": 50, "type": "integer", "description": "Total consecutive pages of listings to scrape (e.g. 1 page = 20 results, 5 pages = 100 results).", "default": 1 }, "pageSize": { "title": "Results Per Page", "type": "integer", "description": "Number of vehicle listings per page (default: 20).", "default": 20 }, "priceMin": { "title": "Minimum Price (EUR)", "type": "integer", "description": "Lower price boundary in Euros." }, "priceMax": { "title": "Maximum Price (EUR)", "type": "integer", "description": "Upper price boundary in Euros." }, "mileageMin": { "title": "Minimum Mileage (km)", "type": "integer", "description": "Lower mileage threshold in kilometers." }, "mileageMax": { "title": "Maximum Mileage (km)", "type": "integer", "description": "Upper mileage threshold in kilometers." }, "firstRegistrationMin": { "title": "First Registration Year (Min)", "type": "integer", "description": "Earliest year of registration (e.g. 2018)." }, "firstRegistrationMax": { "title": "First Registration Year (Max)", "type": "integer", "description": "Latest year of registration (e.g. 2024)." }, "fuelType": { "title": "Fuel & Powertrain Type", "enum": [ "", "PETROL", "DIESEL", "ELECTRICITY", "HYBRID", "HYBRID_DIESEL", "LPG", "CNG", "HYDROGENIUM" ], "type": "string", "description": "Select engine fuel type." }, "bodyType": { "title": "Body Type / Category", "enum": [ "", "OffRoad", "Limousine", "Cabrio", "EstateCar", "SportsCar", "SmallCar", "Van" ], "type": "string", "description": "Select body style configuration." }, "transmission": { "title": "Transmission", "enum": [ "", "AUTOMATIC", "MANUAL", "SEMIAUTOMATIC" ], "type": "string", "description": "Gearbox configuration." }, "drivetrain": { "title": "Drivetrain (4x4 / AWD)", "enum": [ "", "ALL_WHEEL_DRIVE", "FRONT_WHEEL_DRIVE", "REAR_WHEEL_DRIVE" ], "type": "string", "description": "Wheel drive configuration." }, "condition": { "title": "Vehicle Condition", "enum": [ "", "NEW", "USED", "DEMONSTRATION", "CLASSIC" ], "type": "string", "description": "Vehicle age and usage condition." }, "sellerType": { "title": "Seller Type", "enum": [ "", "DEALER", "PRIVATE" ], "type": "string", "description": "Filter by dealer or private advertiser." }, "powerMinHp": { "title": "Minimum Power (HP)", "type": "integer", "description": "Minimum engine horsepower." }, "powerMaxHp": { "title": "Maximum Power (HP)", "type": "integer", "description": "Maximum engine horsepower." }, "color": { "title": "Exterior Color", "enum": [ "", "BLACK", "WHITE", "GREY", "SILVER", "BLUE", "RED", "GREEN", "YELLOW", "BROWN", "ORANGE" ], "type": "string", "description": "Vehicle body paint color." }, "doors": { "title": "Number of Doors", "enum": [ "", "TWO_OR_THREE", "FOUR_OR_FIVE", "SIX_OR_SEVEN" ], "type": "string", "description": "Door count configuration." }, "features": { "title": "Equipment & Features", "type": "array", "description": "Select specific vehicle equipment and premium options.", "default": [ "NAVIGATION", "LEATHER" ], "items": { "type": "string" } }, "vatDeductible": { "title": "VAT Deductible (MwSt. ausweisbar)", "type": "boolean", "description": "Only show vehicles eligible for VAT deduction (for businesses and export)." }, "country": { "title": "Country", "type": "string", "description": "ISO country code (DE, AT, FR, IT, NL, BE, PL, ES, etc.).", "default": "DE" }, "sortBy": { "title": "Sort By", "enum": [ "rel", "doc", "lsr", "msr" ], "type": "string", "description": "Sorting criteria for search results.", "default": "rel" } } }, "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 } } } } } } } } } }