{ "openapi": "3.0.1", "info": { "title": "Mobile.de Scraper: Cars, Prices, Dealers & Ratings", "description": "Scrape mobile.de cars, motorbikes, vans, trucks by make, model, keyword, place, dealer or pasted links, no login, past 2,000 ads a search. Rows carry price, mobile.de price rating, mileage, registration, power, KBA codes, dealer phone. Monitor new ads and price drops; CSV or API, pay per listing.", "version": "0.1", "x-build-id": "idPFNYrjoCgXDxmNL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~mobile-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~mobile-de-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~mobile-de-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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", "properties": { "makeModels": { "title": "Makes and models", "type": "array", "description": "Car makes, or makes with a model, as mobile.de lists them: \"Volkswagen\", \"Volkswagen Golf\", \"BMW 3er Reihe (all)\" (a whole model group), \"Mercedes-Benz C 200\". Ids work too (\"25200;14\"). Cars only; for other vehicle types use Keywords or a search link.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free text searched by mobile.de in the ads (its own keyword search), such as \"GTI\", \"Standheizung\", \"Garantie\".", "items": { "type": "string" } }, "vehicleType": { "title": "Vehicle type", "enum": [ "car", "motorbike", "motorhome", "van", "truck", "semi_trailer_truck", "trailer", "semi_trailer", "bus", "construction", "agricultural", "forklift", "ebike" ], "type": "string", "description": "The kind of vehicle every built search reads. Default: cars. A search link carries its own type." }, "locations": { "title": "Places", "type": "array", "description": "German postcodes (10115) or place names as mobile.de's place service writes them (Berlin, \"Neustadt an der Weinstraße, Rheinland-Pfalz\"), places in France, Italy, Poland or Romania with their country (\"Paris, FR\"), or coordinates (\"52.52, 13.40\"). Each is searched with the radius below. A name the service does not know exactly, or that names several places, is a free row listing what it found.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius in kilometres", "minimum": 1, "maximum": 1000, "type": "integer", "description": "The radius around each place (1 to 1,000 km). Default 50 km when a place is given." }, "country": { "title": "Country of the vehicle", "type": "string", "description": "Only vehicles offered in this country, as a two letter code: DE, AT, NL, BE, IT ... (mobile.de also lists dealers abroad)." }, "dealers": { "title": "Dealers (their stock)", "type": "array", "description": "A dealer's whole stock: the dealer id shown on every row (sellerId, such as 453428) or the dealer's storefront link https://home.mobile.de/. Combined with the makes, keywords, places and filters above.", "items": { "type": "string" } }, "searchUrls": { "title": "mobile.de search links", "type": "array", "description": "Links of mobile.de results pages, https://suchen.mobile.de/fahrzeuge/search.html?... (paste the first page). Every parameter of the link is read; a parameter this Actor does not know refuses the link with a free row, because mobile.de would drop it and search wider. The filters below apply to built searches; the row filters further down apply to links too.", "items": { "type": "string" } }, "adUrls": { "title": "Ad links or ids", "type": "array", "description": "Single ads: https://suchen.mobile.de/fahrzeuge/details.html?id=461171143, the .../auto-inserat//.html links, or the id alone. Each is read with its details and billed as a Listing by URL. A sold, withdrawn or unknown ad is a free row.", "items": { "type": "string" } }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Any of these fuels.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid", "hybrid_diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Petrol (Benzin)", "Diesel", "Electric", "Hybrid (petrol and electric)", "Hybrid (diesel and electric)", "LPG (Autogas)", "CNG (Erdgas)", "Hydrogen", "Ethanol", "Other" ] } }, "gearbox": { "title": "Gearbox", "type": "array", "description": "Any of these gearboxes.", "items": { "type": "string", "enum": [ "automatic", "manual", "semi_automatic" ], "enumTitles": [ "Automatic", "Manual", "Semi automatic" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Any of these body types (cars).", "items": { "type": "string", "enum": [ "saloon", "estate", "suv", "small_car", "cabrio", "sports_car", "van", "other" ], "enumTitles": [ "Saloon (Limousine)", "Estate (Kombi)", "SUV, off road, pickup", "Small car", "Cabrio, roadster", "Sports car, coupe", "Van, minibus", "Other" ] } }, "colors": { "title": "Exterior colour", "type": "array", "description": "Any of these colours.", "items": { "type": "string", "enum": [ "black", "grey", "white", "silver", "blue", "red", "green", "brown", "beige", "yellow", "gold", "orange", "purple" ], "enumTitles": [ "Black", "Grey", "White", "Silver", "Blue", "Red", "Green", "Brown", "Beige", "Yellow", "Gold", "Orange", "Purple" ] } }, "vehicleCategories": { "title": "Special categories", "type": "array", "description": "Only these special categories.", "items": { "type": "string", "enum": [ "employee_car", "classic", "pre_registration", "demonstration" ], "enumTitles": [ "Employee car (Jahreswagen)", "Classic (Oldtimer)", "Pre registered (Tageszulassung)", "Demonstration vehicle" ] } }, "driveTypes": { "title": "Drive", "type": "array", "description": "Any of these drives.", "items": { "type": "string", "enum": [ "all_wheel", "front", "rear" ], "enumTitles": [ "All wheel drive", "Front wheel drive", "Rear wheel drive" ] } }, "emissionClasses": { "title": "Emission class", "type": "array", "description": "Any of these emission classes.", "items": { "type": "string", "enum": [ "euro1", "euro2", "euro3", "euro4", "euro5", "euro6", "euro6c", "euro6d_temp", "euro6d", "euro6e", "euro7" ], "enumTitles": [ "Euro 1", "Euro 2", "Euro 3", "Euro 4", "Euro 5", "Euro 6", "Euro 6c", "Euro 6d-TEMP", "Euro 6d", "Euro 6e", "Euro 7" ] } }, "priceRatings": { "title": "mobile.de price rating", "type": "array", "description": "mobile.de's own price rating of the ad against the market (Sehr guter Preis, Guter Preis ...).", "items": { "type": "string", "enum": [ "very_good", "good", "reasonable", "increased", "high", "no_rating" ], "enumTitles": [ "Very good price", "Good price", "Fair price", "Increased price", "High price", "No rating" ] } }, "condition": { "title": "Condition", "enum": [ "any", "used", "new" ], "type": "string", "description": "New or used vehicles.", "default": "any" }, "sellerType": { "title": "Seller", "enum": [ "any", "dealer", "private", "company" ], "type": "string", "description": "Dealers, private sellers or company cars.", "default": "any" }, "damaged": { "title": "Damaged vehicles", "enum": [ "any", "exclude", "only" ], "type": "string", "description": "mobile.de's damaged vehicle filter.", "default": "any" }, "vat": { "title": "VAT (MwSt.)", "enum": [ "any", "reclaimable", "not_reclaimable" ], "type": "string", "description": "Vehicles whose VAT a business can reclaim (the seller shows a net price), or not.", "default": "any" }, "doors": { "title": "Doors", "enum": [ "any", "two_or_three", "four_or_five", "six_or_seven" ], "type": "string", "description": "Number of doors.", "default": "any" }, "emissionSticker": { "title": "Emission sticker", "enum": [ "any", "green", "yellow", "red", "none" ], "type": "string", "description": "The German environmental sticker (Umweltplakette), at least this one.", "default": "any" }, "minPrice": { "title": "Price from (EUR)", "minimum": 0, "maximum": 99999999, "type": "integer", "description": "Price in euros, at least." }, "maxPrice": { "title": "Price to (EUR)", "minimum": 0, "maximum": 99999999, "type": "integer", "description": "Price in euros, at most." }, "yearMin": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "First registration year, at least." }, "yearMax": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "First registration year, at most." }, "mileageMin": { "title": "Mileage from (km)", "minimum": 0, "maximum": 9999999, "type": "integer", "description": "Kilometres, at least." }, "mileageMax": { "title": "Mileage to (km)", "minimum": 0, "maximum": 9999999, "type": "integer", "description": "Kilometres, at most." }, "powerMinKw": { "title": "Power from (kW)", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Engine power in kW, at least." }, "powerMaxKw": { "title": "Power to (kW)", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Engine power in kW, at most." }, "powerMinHp": { "title": "Power from (hp)", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Engine power in hp (PS), at least: sent to mobile.de in kW and checked on each row in hp. Give power in kW or in hp, not both." }, "powerMaxHp": { "title": "Power to (hp)", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Engine power in hp (PS), at most." }, "seatsMin": { "title": "Seats from", "minimum": 0, "maximum": 99, "type": "integer", "description": "Number of seats, at least." }, "seatsMax": { "title": "Seats to", "minimum": 0, "maximum": 99, "type": "integer", "description": "Number of seats, at most." }, "engineSizeMin": { "title": "Engine size from (ccm)", "minimum": 0, "maximum": 99999, "type": "integer", "description": "Cubic capacity, at least." }, "engineSizeMax": { "title": "Engine size to (ccm)", "minimum": 0, "maximum": 99999, "type": "integer", "description": "Cubic capacity, at most." }, "previousOwnersMax": { "title": "Previous owners, at most", "minimum": 1, "maximum": 4, "type": "integer", "description": "At most this many previous owners (1 to 4). Allowed values: 1, 2, 3, 4." }, "huValidMonths": { "title": "HU (TUEV) valid for at least (months)", "minimum": 0, "maximum": 18, "type": "integer", "description": "The general inspection (HU) still valid for at least this many months; 0 means new HU. Allowed values: 0, 3, 6, 9, 12, 18." }, "onlineWithinDays": { "title": "Online for at most (days)", "minimum": 1, "maximum": 14, "type": "integer", "description": "mobile.de's own \"online since\" filter: ads put online within the last 1, 3, 7 or 14 days (works with any sort). Allowed values: 1, 3, 7, 14." }, "minDealerRating": { "title": "Dealer rating, at least (stars)", "minimum": 3, "maximum": 5, "type": "integer", "description": "Dealers rated at least 3, 4 or 5 stars. Allowed values: 3, 4, 5." }, "roadworthyOnly": { "title": "Roadworthy only", "type": "boolean", "description": "Vehicles their seller marks as roadworthy (fahrtauglich).", "default": false }, "withPicturesOnly": { "title": "With pictures only", "type": "boolean", "description": "Ads with pictures.", "default": false }, "priceReducedOnly": { "title": "Reduced price only", "type": "boolean", "description": "Ads whose price was reduced.", "default": false }, "withVideoOnly": { "title": "With video only", "type": "boolean", "description": "Ads with a video.", "default": false }, "qualitySealOnly": { "title": "With a quality seal only", "type": "boolean", "description": "Ads with a manufacturer's used car quality seal.", "default": false }, "leasingOnly": { "title": "Leasing offers only", "type": "boolean", "description": "Ads offered with leasing.", "default": false }, "excludeExportOffers": { "title": "Leave out export and trade offers", "type": "boolean", "description": "mobile.de's \"Fuer Gewerbe, Ex-/Import\" exclusion.", "default": false }, "features": { "title": "Equipment", "type": "array", "description": "Vehicles with all of this equipment, as mobile.de lists it (its German names shown).", "items": { "type": "string", "enum": [ "ABS", "AIR_SUSPENSION", "ALARM_SYSTEM", "ALLOY_WHEELS", "ALL_SEASON_TIRES", "AMBIENT_LIGHTING", "ANDROID_AUTO", "ARM_REST", "AUTOMATIC_RAIN_SENSOR", "AUXILIARY_HEATING", "BATTERY_HEALTH_CERT", "BENDING_LIGHTS", "BIDIRECTIONAL_CHARGING", "BIODIESEL_SUITABLE", "BLIND_SPOT_MONITOR", "BLUETOOTH", "CARGO_BARRIER", "CARPLAY", "CD_MULTICHANGER", "CD_PLAYER", "CENTRAL_LOCKING", "COLLISION_AVOIDANCE", "CRUISE_CONTROL", "DAYTIME_RUNNING_LIGHTS", "DIGITAL_COCKPIT", "DIMMING_INTERIOR_MIRROR", "DISABLED_ACCESSIBLE", "DISTANCE_WARNING_SYSTEM", "DYNAMIC_CHASSIS_CONTROL", "E10_ENABLED", "ELECTRIC_ADJUSTABLE_SEATS", "ELECTRIC_BACKSEAT_ADJUSTMENT", "ELECTRIC_EXTERIOR_MIRRORS", "ELECTRIC_HEATED_REAR_SEATS", "ELECTRIC_HEATED_SEATS", "ELECTRIC_TAILGATE", "ELECTRIC_WINDOWS", "EMERGENCY_CALL_SYSTEM", "ENVIRONMENTAL_BONUS", "ESP", "EXPORT", "FATIGUE_WARNING_SYSTEM", "FOLDING_EXTERIOR_MIRRORS", "FOLDING_ROOF", "FOLD_FLAT_PASSENGER_SEAT", "FRONT_FOG_LIGHTS", "FULL_SERVICE_HISTORY", "GLARE_FREE_HIGH_BEAM", "HANDS_FREE_PHONE_SYSTEM", "HEADLIGHT_WASHER_SYSTEM", "HEAD_UP_DISPLAY", "HEATED_STEERING_WHEEL", "HEATED_WINDSHIELD", "HEAT_PUMP", "HIGH_BEAM_ASSIST", "HILL_START_ASSIST", "HU_AU_NEU", "HYBRID_PLUGIN", "IMMOBILIZER", "INTEGRATED_MUSIC_STREAMING", "ISOFIX", "KEYLESS_ENTRY", "LANE_DEPARTURE_WARNING", "LEATHER_SEATS", "LEATHER_STEERING_WHEEL", "LIGHT_SENSOR", "LUMBAR_SUPPORT", "MASSAGE_SEATS", "MATTE_COLOR", "MEMORY_SEATS", "METALLIC", "MP3_INTERFACE", "MULTIFUNCTIONAL_WHEEL", "NAVIGATION_SYSTEM", "NEW_SERVICE", "NIGHT_VISION_ASSIST", "NONSMOKER_VEHICLE", "ON_BOARD_COMPUTER", "PADDLE_SHIFTERS", "PANORAMIC_GLASS_ROOF", "PARKING_SENSORS", "PARTICULATE_FILTER_DIESEL", "PASSENGER_SEAT_ISOFIX_POINT", "PERFORMANCE_HANDLING_SYSTEM", "POWER_ASSISTED_STEERING", "RANGE_EXTENDER", "REAR_TRAFFIC_ALERT", "RIGHT_HAND_DRIVE", "ROOF_RAILS", "SKI_BAG", "SMOKERS_PACKAGE", "SOUND_SYSTEM", "SPEED_LIMITER", "SPORT_PACKAGE", "SPORT_SEATS", "START_STOP_SYSTEM", "STEEL_WHEELS", "SUMMER_TIRES", "SUNROOF", "TAXI", "TINTED_WINDOWS", "TIRE_PRESSURE_MONITORING", "TOUCHSCREEN", "TRACTION_CONTROL_SYSTEM", "TRAFFIC_SIGN_RECOGNITION", "TRAILER_ASSIST", "TRAILER_COUPLING", "TUNER", "TV", "USB", "VEGETABLEOILFUEL_SUITABLE", "VENTILATED_SEATS", "VIRTUAL_SIDE_MIRROR", "VOICE_CONTROL", "WARRANTY", "WIFI_HOTSPOT", "WINTER_PACKAGE", "WINTER_TIRES", "WIRELESS_CHARGING", "XENON_HEADLIGHTS" ], "enumTitles": [ "ABS", "Luftfederung", "Alarmanlage", "Leichtmetallfelgen", "Allwetterreifen", "Ambiente-Beleuchtung", "Android Auto", "Armlehne", "Regensensor", "Standheizung", "Mit Batterie-Zertifikat", "Kurvenlicht", "Bidirektionales Laden", "Biodiesel geeignet", "Spurwechselassistent", "Bluetooth", "Gepäckraumabtrennung", "Apple CarPlay", "Multi-CD-Wechsler", "CD-Spieler", "Zentralverriegelung", "Notbremsassistent", "Tempomat", "Tagfahrlicht", "Volldigitales Kombiinstrument", "Innenspiegel autom. abblendend", "Behindertengerecht", "Abstandswarner", "Adaptives Fahrwerk", "E10-geeignet", "Elektr. Sitzeinstellung", "Elektr. Sitzeinstellung, hinten", "Elektr. Seitenspiegel", "Sitzheizung hinten", "Sitzheizung", "Elektr. Heckklappe", "Elektr. Fensterheber", "Notrufsystem", "Mit BAFA-Umweltbonus", "ESP", "Für Gewerbe, Ex-/Import", "Müdigkeitswarner", "Elektr. Seitenspiegel anklappbar", "Faltdach", "Umklappbarer Beifahrersitz", "Nebelscheinwerfer", "Scheckheftgepflegt", "Blendfreies Fernlicht", "Freisprecheinrichtung", "Scheinwerferreinigung", "Head-Up Display", "Beheizbares Lenkrad", "Beheizbare Frontscheibe", "Wärmepumpe", "Fernlichtassistent", "Berganfahrassistent", "HU neu", "Plug-in-Hybrid", "Elektr. Wegfahrsperre", "Musikstreaming integriert", "Isofix", "Keyless Entry", "Spurhalteassistent", "Lederausstattung", "Lederlenkrad", "Lichtsensor", "Lordosenstütze", "Massagesitze", "Matt", "Elektr. Sitzeinstellung mit Memory-Funktion", "Metallic", "MP3-Schnittstelle", "Multifunktionslenkrad", "Navigationssystem", "Inspektion neu", "Nachtsicht-Assistent", "Nichtraucher-Fahrzeug", "Bordcomputer", "Schaltwippen", "Panorama-Dach", "Einparkhilfe", "Partikelfilter", "Isofix Beifahrersitz", "Sportfahrwerk", "Servolenkung", "Range Extender", "Ausparkassistent", "Rechtslenker anzeigen", "Dachreling", "Skisack", "Raucherpaket", "Soundsystem", "Geschwindigkeitsbegrenzer", "Sportpaket", "Sportsitze", "Start/Stopp-Automatik", "Stahlfelgen", "Sommerreifen", "Schiebedach", "Taxi", "Abgedunkelte Scheiben", "Reifendruckkontrolle", "Touchscreen", "Traktionskontrolle", "Verkehrszeichenerkennung", "Anhängerrangierassistent", "Anhängerkupplung", "Tuner/Radio", "TV", "USB", "Pflanzenöl geeignet", "Sitzbelüftung", "Virtuelle Seitenspiegel", "Sprachsteuerung", "Garantie", "WLAN / Wifi Hotspot", "Winterpaket", "Winterreifen", "Induktionsladen für Smartphones", "Xenonscheinwerfer" ] } }, "excludeMakeModels": { "title": "Leave out makes and models", "type": "array", "description": "Makes or models mobile.de leaves out of every built search, written like Makes and models (\"Volkswagen Golf Plus\", \"Dacia\").", "items": { "type": "string" } }, "filters": { "title": "Other mobile.de filters", "type": "object", "description": "Any other filter of mobile.de's search by its own parameter name: a list of values or {\"min\": n, \"max\": n}. Examples: {\"clim\": [\"AUTOMATIC_CLIMATISATION\"], \"it\": [\"LEATHER\"], \"cy\": {\"min\": 6}, \"tct\": [\"TRAILER_COUPLING_FIX\"]}. Values are mobile.de's own; an unknown name or value refuses the run with a free row." }, "includeKeywords": { "title": "Keep only rows holding a word", "type": "array", "description": "Keep a row only when its title or subtitle (and its description and equipment, with details on) holds at least one of these words as a whole word, case not mattering.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Leave out rows holding a word", "type": "array", "description": "Leave a row out when its title or subtitle (and its description and equipment, with details on) holds one of these words as a whole word (\"Unfall\", \"Motorschaden\", \"Bastler\").", "items": { "type": "string" } }, "customFilters": { "title": "Custom filters on any output field", "type": "array", "description": "Rules on the delivered row: [{\"field\": \"powerHp\", \"op\": \"gte\", \"value\": 150}, {\"field\": \"description\", \"op\": \"notIncludes\", \"value\": \"Export\"}]. Ops: includes, notIncludes, equals, notEquals (texts and numbers), gt, gte, lt, lte (numbers). Fields: price, priceNet, mileageKm, firstRegistrationYear, powerKw, powerHp, engineSizeCcm, seats, previousOwners, imageCount, dealerRating, dealerRatingCount, leasingRateMonthly, title, subtitle, make, model, fuel, gearbox, bodyType, color, emissionClass, city, postcode, country, sellerType, dealerName, priceRating, description, features, category. A row without the field fails every rule except notEquals and notIncludes." }, "postedWithinHours": { "title": "Online since at most N hours", "minimum": 1, "maximum": 720, "type": "integer", "description": "Ads put online within this many hours of the run's start (mobile.de's online date, German time). Needs the newest or oldest sort; a newest first search stops once it passes the window." }, "postedWithinDays": { "title": "Online since at most N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "The same window in days. Give one of hours, days or a date." }, "postedAfter": { "title": "Online since on or after (date)", "type": "string", "description": "Ads put online on or after this day (German time), YYYY-MM-DD." }, "postedBefore": { "title": "Online since on or before (date)", "type": "string", "description": "Ads put online on or before this day (German time), YYYY-MM-DD." }, "excludeAdIds": { "title": "Ads you already have (links or ids)", "type": "array", "description": "Ad links or ids skipped free on every search (up to 5,000), such as the adId values of an earlier run.", "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "newest", "oldest", "price_low", "price_high", "mileage_low", "mileage_high", "registration_new", "registration_old", "relevance" ], "type": "string", "description": "The order mobile.de returns ads in. A monitor reads newest first. When a search is split into price slices, each slice is read in this order.", "default": "newest" }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most listing rows the run delivers (searches and links together). Default 100." }, "maxItemsPerSearch": { "title": "Maximum listings per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most listing rows one search or search link may deliver." }, "maxPagesPerSearch": { "title": "Maximum pages per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most results pages (20 vehicles each) read per search, slices included. Without it a search is read to its end or to the caps. A monitor reads 3 pages per search by default." }, "startPage": { "title": "Start at page", "minimum": 1, "maximum": 100, "type": "integer", "description": "Begin each search at this results page (1 to 100), to continue a walk an earlier run stopped." }, "splitLargeSearches": { "title": "Read past 2,000 ads by price slices", "type": "boolean", "description": "mobile.de serves at most 2,000 ads (100 pages) of one search. On (default), a larger search is split into whole euro price slices and every slice is read, so the caps decide how far the run goes; the coverage row says what could not be reached. Not used by a monitor.", "default": true }, "includeTopAds": { "title": "Include promoted top ads", "type": "boolean", "description": "mobile.de shows one promoted vehicle above page 1 of a search. On (default), it is delivered like any row when it passes every filter (placement: topAd). Highlighted ads within the results are always included (placement: highlighted).", "default": true }, "includeDetails": { "title": "Listing details (description, equipment, dealer)", "type": "boolean", "description": "Read each row's details: the full description, the equipment list, every attribute (consumption, CO2, battery, cylinders, last service ...), all photos, the finance plan, and for dealers the address, all phone numbers, opening hours, contact person, rating breakdown and the 2 newest reviews. Billed as Listing details per row, only when read.", "default": false }, "includeDealerProfiles": { "title": "Dealer profiles (reviews, e-mails, website)", "type": "boolean", "description": "For dealer rows, read the dealer's storefront and rating pages once per dealer per run: up to 10 reviews with their texts, the e-mail addresses and website the dealer shows. mobile.de allows only a handful of these pages per run (10 pages, 3 per dealer: about 3 dealers); rows past that are delivered without the profile and without its charge. Billed as Dealer profile once per dealer.", "default": false }, "maxDealerReviews": { "title": "Reviews per dealer profile", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many reviews a dealer profile carries (0 to 10, default 10)." }, "language": { "title": "Language of labels", "enum": [ "de", "en" ], "type": "string", "description": "The language of mobile.de's labels on the rows (fuel, gearbox, body type, attributes, equipment). Numbers are the same either way; sellers' own texts stay as written.", "default": "de" }, "currency": { "title": "Also show prices in", "enum": [ "EUR", "USD", "GBP", "CHF", "PLN", "CZK", "SEK", "DKK", "NOK", "HUF", "RON", "BGN", "TRY", "JPY", "CAD", "AUD" ], "type": "string", "description": "Adds the price converted at the European Central Bank's reference rate of the day (the rate and its date are on the row). Prices stay in euros as well.", "default": "EUR" }, "imageSize": { "title": "Image size", "enum": [ "small", "medium", "large" ], "type": "string", "description": "The size of the image links on the rows.", "default": "large" }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "markdown", "html", "all" ], "type": "string", "description": "How the description of the details is delivered.", "default": "text" }, "descriptionMaxLength": { "title": "Description length limit", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cut descriptions to this many characters." }, "compactOutput": { "title": "Compact rows", "type": "boolean", "description": "Deliver only the core fields (for agents and quick sheets), plus the details and the dealer profile when you asked for them.", "default": false }, "excludeEmptyFields": { "title": "Leave out empty fields", "type": "boolean", "description": "Drop fields that are empty on a row.", "default": false }, "includePersonalData": { "title": "Personal data of private sellers", "type": "boolean", "description": "Off (default): for private sellers and company cars, the phone number mobile.de shows is not delivered, phone numbers and e-mail addresses in their own title, subtitle and description are replaced, and the exact location of the details is rounded to about 1 km. On: those fields are delivered as mobile.de shows them. You are responsible for using personal data lawfully (GDPR included). Dealers' names, addresses and phone numbers are business data and always delivered.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "A short name (letters, digits, spaces and . _ , - : # ( ), up to 60) that keeps this search's memory between runs. A memory belongs to one set of settings." }, "trackChanges": { "title": "Track price changes and removals", "type": "boolean", "description": "With a monitor: a known ad whose price changed is delivered again with its change (previous price, difference, first seen price, history, drop in percent) as a Listing update; an ad that a later complete run no longer meets is reported as removed (a Listing update), and a removed ad that comes back is delivered as reappeared.", "default": false }, "trackFields": { "title": "Changes that count", "type": "array", "description": "With change tracking: the fields whose change delivers a known ad again as a Listing update (default: price only). A row names the fields that changed (changedFields); a change of a field other than price comes with changeType updated.", "items": { "type": "string", "enum": [ "price", "priceNet", "mileageKm", "title", "subtitle", "firstRegistration", "powerKw", "fuel", "gearbox" ], "enumTitles": [ "Price", "Net price (VAT)", "Mileage", "Title", "Subtitle", "First registration", "Power", "Fuel", "Gearbox" ] } }, "emitUnchanged": { "title": "Deliver known ads again", "type": "boolean", "description": "With a monitor: deliver known ads again too (changeType: unchanged), billed as Listing, for a full snapshot every run.", "default": false }, "markReposts": { "title": "Mark reposts", "type": "boolean", "description": "With a monitor: a new ad with the same dealer id, make, model, first registration, mileage and power as an ad the monitor delivered under another id carries possibleRepostOf.", "default": false }, "skipReposts": { "title": "Leave reposts out", "type": "boolean", "description": "With a monitor: leave such reposts out, free.", "default": false }, "notificationLimit": { "title": "Listings per notification", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many listings each notification channel names per run (1 to 30, default 10)." }, "notifyOnlyChanges": { "title": "Notify only new and changed listings", "type": "boolean", "description": "With a monitor and Deliver known ads again: leave unchanged listings out of the notifications.", "default": true }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Your own bot's token from BotFather: each run sends its listings to the chat below. Free." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Your chat id (a number) or a channel name starting with @ where your bot can post." }, "slackWebhookUrl": { "title": "Slack incoming webhook", "type": "string", "description": "A Slack incoming webhook link (https://hooks.slack.com/...): one message per run with the listings. Free." }, "discordWebhookUrl": { "title": "Discord webhook", "type": "string", "description": "A Discord channel webhook link (https://discord.com/api/webhooks/...): one message per run with the listings. Free." }, "whatsappAccessToken": { "title": "WhatsApp Cloud API token", "type": "string", "description": "Your WhatsApp Business Cloud API access token (Meta): one message per run to the number below. Meta delivers free text only within 24 hours of the recipient's last message to your number. Free here; Meta may charge you." }, "whatsappPhoneNumberId": { "title": "WhatsApp phone number id", "type": "string", "description": "The phone number id of your WhatsApp Business account (digits, from the Meta dashboard)." }, "whatsappTo": { "title": "WhatsApp recipient", "type": "string", "description": "The recipient's number in international form without +, such as 491701234567." }, "webhookUrl": { "title": "Webhook link", "type": "string", "description": "An https address that receives the listings of each run as JSON (batches of 100, up to 1,000 a run). Free." }, "webhookSecret": { "title": "Webhook secret", "type": "string", "description": "Signs each webhook call: header x-signature-sha256 is the HMAC SHA-256 of the body with this secret (8 to 200 characters)." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Extra headers for the webhook call, such as {\"Authorization\": \"Bearer ...\"} (at most 10)." }, "failIfIncomplete": { "title": "Fail the run when a search is incomplete", "type": "boolean", "description": "Mark the run as failed when a search or an ad link could not be read to its end (mobile.de refused, a page failed, a filter was not applied, the work allowance ran out). Rows delivered stay delivered and billed.", "default": false }, "requestsPerSecond": { "title": "Requests per second", "minimum": 0.5, "maximum": 2, "type": "number", "description": "The pace of requests to mobile.de (0.5 to 2, default 1.5). One request is in flight at a time." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify residential proxies in Germany are used by default and included in the price (mobile.de refuses Apify's datacenter addresses). Other Apify groups or countries are refused; your own proxy links (http://user:password@host:port) are used as given." } } }, "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 } } } } } } } } } }