{ "openapi": "3.0.1", "info": { "title": "mobile.de $0.8💰 URL Search | Keyword Filtering | Rich Output", "description": "From $0.8/1K. Scrape mobile.de vehicle listings with 30+ structured fields including price, registration, mileage, power, fuel, transmission, location, and dealer info. Optional detail enrichment adds description, equipment, image gallery, and dealer profile.", "version": "2.0", "x-build-id": "bI2lMszTRTMjDarIl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~mobile-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-mobile-de-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/abotapi~mobile-de-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-mobile-de-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/abotapi~mobile-de-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-mobile-de-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", "required": [ "mode" ], "properties": { "mode": { "title": "Search mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose how to find listings. Only fields belonging to the chosen mode are used.", "default": "search" }, "urls": { "title": "URLs (URL mode only)", "type": "array", "description": "Paste one or more mobile.de search or vehicle URLs. Each search URL is auto-paginated forward until Maximum Pages or Maximum Listings. Vehicle detail URLs are scraped directly. Filter fields are ignored in URL mode. Examples: https://suchen.mobile.de/auto/audi-a4.html or https://suchen.mobile.de/fahrzeuge/details.html?id=451972553", "items": { "type": "string" } }, "vehicleClass": { "title": "Vehicle class", "enum": [ "Car", "Motorbike", "VanUpTo7500", "TruckOver7500", "Bus", "Trailer", "Motorhome", "SemiTrailer", "SemiTrailerTruck", "ConstructionMachine", "AgriculturalVehicle", "ForkLiftTruck" ], "type": "string", "description": "Vehicle category. (Search mode only.)", "default": "Car" }, "make": { "title": "Make", "type": "string", "description": "Manufacturer name as it appears on mobile.de (e.g. BMW, Audi, Mercedes-Benz, Volkswagen, Porsche). Leave empty for all makes. (Search mode only.)" }, "model": { "title": "Model", "type": "string", "description": "Model name (e.g. X5, A4, C-Klasse, Golf, 911). Requires a Make. (Search mode only.)" }, "condition": { "title": "Condition", "enum": [ "", "NEW", "USED", "EMPLOYEES_CAR", "OLDTIMER", "DEMONSTRATION" ], "type": "string", "description": "Vehicle condition. (Search mode only.)", "default": "" }, "fuels": { "title": "Fuel type(s)", "uniqueItems": true, "type": "array", "description": "Multi-select. Leave empty for any fuel. (Search mode only.)", "items": { "type": "string", "enum": [ "PETROL", "DIESEL", "HYBRID", "ELECTRICITY", "HYBRID_DIESEL", "LPG", "CNG", "HYDROGEN", "ETHANOL", "OTHER" ], "enumTitles": [ "Petrol", "Diesel", "Hybrid (Petrol/Electric)", "Electric", "Hybrid (Diesel/Electric)", "LPG", "CNG", "Hydrogen", "Ethanol (E85)", "Other" ] }, "default": [] }, "transmission": { "title": "Transmission", "enum": [ "", "AUTOMATIC_GEAR", "MANUAL_GEAR", "SEMIAUTOMATIC_GEAR" ], "type": "string", "description": "Gearbox type. (Search mode only.)", "default": "" }, "bodyType": { "title": "Body type", "enum": [ "", "CABRIO", "ESTATECAR", "LIMOUSINE", "OFFROAD", "OTHERCAR", "SMALLCAR", "SPORTSCAR", "VAN" ], "type": "string", "description": "Body shape. Cars only. (Search mode only.)", "default": "" }, "country": { "title": "Listing country", "enum": [ "", "DE", "AT", "BE", "BG", "CH", "CZ", "DK", "EE", "ES", "FI", "FR", "GB", "GR", "HR", "HU", "IE", "IT", "LT", "LU", "LV", "MT", "NL", "NO", "PL", "PT", "RO", "SE", "SI", "SK", "UA" ], "type": "string", "description": "Country where the vehicle is offered. DE covers the bulk of mobile.de inventory. (Search mode only.)", "default": "DE" }, "zipcode": { "title": "Postal code", "type": "string", "description": "Postal code in the chosen country, used together with Radius. (Search mode only.)" }, "radiusKm": { "title": "Radius around postal code (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Radius around the postal code. Ignored unless Postal code is set. (Search mode only.)" }, "priceFrom": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Lower bound for price. (Search mode only.)" }, "priceTo": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Upper bound for price. (Search mode only.)" }, "yearFrom": { "title": "Minimum first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest first-registration year. (Search mode only.)" }, "yearTo": { "title": "Maximum first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest first-registration year. (Search mode only.)" }, "mileageFrom": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Lower bound for mileage. (Search mode only.)" }, "mileageTo": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Upper bound for mileage. (Search mode only.)" }, "powerFromKw": { "title": "Minimum power (kW)", "minimum": 0, "type": "integer", "description": "Lower bound for engine power in kW. 1 hp ~= 0.735 kW. (Search mode only.)" }, "powerToKw": { "title": "Maximum power (kW)", "minimum": 0, "type": "integer", "description": "Upper bound for engine power in kW. (Search mode only.)" }, "excludeDamaged": { "title": "Exclude damaged vehicles", "type": "boolean", "description": "Hide vehicles flagged as damaged or accident. (Search mode only.)", "default": true }, "sortBy": { "title": "Sort order", "enum": [ "RELEVANCE", "PRICE_ASC", "PRICE_DESC", "FIRST_REGISTRATION_DESC", "FIRST_REGISTRATION_ASC", "MILEAGE_ASC", "MILEAGE_DESC", "CREATION_TIME" ], "type": "string", "description": "How results are ordered. (Search mode only; in URL mode the sort comes from the URL.)", "default": "RELEVANCE" }, "fetchDetails": { "title": "Fetch full vehicle detail", "type": "boolean", "description": "Pull extra fields per listing from the detail page: full description, equipment list, full image gallery, registration codes (HSN/TSN), highlights, finance plan, and full dealer profile with address, opening hours, languages, phones list. Adds ~1 fetch per listing.", "default": true }, "includeSponsored": { "title": "Include sponsored Top-Anzeige listings", "type": "boolean", "description": "Mobile.de injects 1-3 paid sponsored placements at the top of every result page; these always appear regardless of your filter. Off by default so filtered runs only return matching listings. Turn on if you want every entry the user sees, sponsored placements included.", "default": false }, "maxListings": { "title": "Maximum listings", "minimum": 0, "type": "integer", "description": "Stop after scraping this many listings across the whole run. 0 = unlimited.", "default": 20 }, "maxPages": { "title": "Maximum pages per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Per-search page cap (~15-20 unique listings per page after dedup + sponsored filter). Default 1000 = effectively unlimited; the run is bounded by Maximum listings instead. The actor walks forward until either this cap, maxListings, OR mobile.de's actual inventory exhausts (two consecutive empty pages auto-stop the loop). For filter slices with very deep inventory (e.g. all BMW = ~130k listings), plan to fan out into multiple model-narrowed runs since mobile.de's server stops serving past ~100-150 pages.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Mobile.de uses a behavioural edge filter that rejects most datacenter ranges. RESIDENTIAL with the country pinned to any EU country mobile.de covers (DE, AT, NL, FR, IT, ES, BE, CH, ...) works. DE is the default since most listings are in Germany, but feel free to change." } } }, "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 } } } } } } } } } }