{ "openapi": "3.0.1", "info": { "title": "mobile.de Scraper - Car Listings & Seller Leads", "description": "[$0.55 / 1K listings] Scrape mobile.de car listings with the seller's phone number, dealer rating and dealer-or-private flag on every row. No start fee.", "version": "0.1", "x-build-id": "TF1YlslrNzQARBoff" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~mobile-de-car-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-mobile-de-car-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/webdata_labs~mobile-de-car-scraper/runs": { "post": { "operationId": "runs-sync-webdata_labs-mobile-de-car-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/webdata_labs~mobile-de-car-scraper/run-sync": { "post": { "operationId": "run-sync-webdata_labs-mobile-de-car-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": { "searchUrls": { "title": "mobile.de search URLs", "type": "array", "description": "Open mobile.de, filter exactly how you want, then paste the URL of the results page here. This is the most precise way to search and it overrides the filters below. Leave empty to build the search from the fields underneath.", "items": { "type": "string" } }, "makes": { "title": "Makes", "type": "array", "description": "Car makes by name, e.g. Volkswagen, BMW, Porsche. Each make is searched separately. Ignored when search URLs are given.", "items": { "type": "string" } }, "modelDescription": { "title": "Model / trim contains", "type": "string", "description": "Free text matched against the model and trim line, e.g. \"Golf GTI\". Works together with Makes." }, "maxListings": { "title": "Max listings", "minimum": 0, "maximum": 50000, "type": "integer", "description": "How many listing rows to return in total, across all searches. mobile.de serves 20-24 per page.", "default": 100 }, "vehicleCategory": { "title": "Vehicle category", "enum": [ "Car", "Motorbike", "VanUpTo7500", "Motorhome", "TruckOverSevenFiveTons", "SemiTrailerTruck", "Trailer", "ConstructionMachine", "AgriculturalVehicle", "ForkliftTruck", "Bus" ], "type": "string", "description": "Which mobile.de marketplace to search.", "default": "Car" }, "priceMinEur": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Lowest asking price to include." }, "priceMaxEur": { "title": "Price up to (EUR)", "minimum": 0, "type": "integer", "description": "Highest asking price to include." }, "firstRegistrationFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest model year to include, e.g. 2020." }, "firstRegistrationTo": { "title": "First registration up to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest model year to include." }, "mileageMaxKm": { "title": "Mileage up to (km)", "minimum": 0, "type": "integer", "description": "Highest odometer reading to include." }, "powerMinKw": { "title": "Power from (kW)", "minimum": 0, "type": "integer", "description": "Lowest engine power to include. 1 kW is about 1.36 hp." }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Leave empty for any fuel.", "items": { "type": "string", "enum": [ "PETROL", "DIESEL", "ELECTRICITY", "HYBRID", "HYBRID_DIESEL", "LPG", "CNG", "ETHANOL", "HYDROGENIUM", "OTHER" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (petrol/electric)", "Hybrid (diesel/electric)", "LPG", "CNG", "Ethanol", "Hydrogen", "Other" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Leave empty for any gearbox.", "items": { "type": "string", "enum": [ "AUTOMATIC_GEAR", "MANUAL_GEAR", "SEMIAUTOMATIC_GEAR" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "bodyTypes": { "title": "Body types", "type": "array", "description": "Car body styles. Leave empty for any.", "items": { "type": "string", "enum": [ "Limousine", "EstateCar", "OffRoad", "SmallCar", "Cabrio", "SportsCar", "Van", "OtherCar" ], "enumTitles": [ "Saloon", "Estate", "SUV / pickup", "Small car", "Convertible", "Coupe / sports car", "Van / minibus", "Other" ] } }, "condition": { "title": "Condition", "enum": [ "NEW", "USED" ], "type": "string", "description": "New or used vehicles only." }, "sellerType": { "title": "Seller type", "enum": [ "DEALER", "FSBO", "COMM_FSBO" ], "type": "string", "description": "Dealers, private sellers, or company-owned vehicles. Private sellers are the ones dealers buy from." }, "minSellerRating": { "title": "Minimum dealer rating", "enum": [ "3", "4", "5" ], "type": "string", "description": "Only dealers rated at least this many stars. mobile.de offers 3, 4 and 5 only." }, "priceRatings": { "title": "mobile.de price rating", "type": "array", "description": "mobile.de's own verdict on whether a car is priced below the market. The shortcut to under-priced stock.", "items": { "type": "string", "enum": [ "VERY_GOOD_PRICE", "GOOD_PRICE", "REASONABLE_PRICE" ], "enumTitles": [ "Very good price", "Good price", "Fair price" ] } }, "priceReducedOnly": { "title": "Only listings whose price was cut", "type": "boolean", "description": "Sellers who have already dropped the price are the ones willing to negotiate.", "default": false }, "onlineSinceDays": { "title": "Listed within the last N days", "enum": [ "1", "3", "7", "14" ], "type": "string", "description": "Only listings published recently. Set to 1 day and schedule the run daily to watch a market for new stock." }, "excludeDamaged": { "title": "Hide damaged vehicles", "type": "boolean", "description": "Leave on to skip accident and repair projects.", "default": true }, "centerLatLon": { "title": "Search around this point", "type": "string", "description": "Centre of a radius search as \"latitude,longitude\", e.g. 52.52,13.405 for Berlin. Use with Radius." }, "radiusKm": { "title": "Radius", "enum": [ "10", "20", "50", "100", "200", "500" ], "type": "string", "description": "How far from the centre point to search. mobile.de offers these steps only." }, "sellerIds": { "title": "Dealer IDs", "type": "array", "description": "Scrape one dealer's whole stock. The ID is the sellerId field on any row from that dealer.", "items": { "type": "string" } }, "fullTextQuery": { "title": "Search the vehicle description", "type": "string", "description": "Free text matched against the seller's description text, e.g. \"Standheizung\"." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "mileageAsc", "firstRegistrationDesc", "newestListing" ], "type": "string", "description": "Which results come first.", "default": "relevance" }, "includeVehicleDetails": { "title": "Also open each vehicle's own page", "type": "boolean", "description": "Adds the full equipment list, the seller's description, all photo URLs and the dealer's street address and opening hours. Slower, and billed per detail page.", "default": false }, "maxVehicleDetails": { "title": "Max vehicle detail pages", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Cap on how many detail pages to open, so a wide search cannot run up a bill.", "default": 25 }, "listingUrls": { "title": "Vehicle URLs or IDs", "type": "array", "description": "Scrape specific vehicles directly. Paste mobile.de details.html URLs or bare listing IDs.", "items": { "type": "string" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }