{ "openapi": "3.0.1", "info": { "title": "mobile.de Scraper - Cars, Prices, Dealers & Vehicle Data", "description": "Scrape mobile.de vehicle listings with 30+ fields including price, mileage, registration, power, fuel, transmission, location and dealer details. Optional enrichment adds descriptions, equipment, images and dealer profiles.", "version": "3.0", "x-build-id": "aETwE6PtcQxYuc1Ma" }, "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" }, "vehicleClass": { "title": "Vehicle class", "enum": [ "Car", "Motorbike", "VanUpTo7500", "TruckOver7500", "Bus", "Trailer", "Motorhome", "SemiTrailer", "SemiTrailerTruck", "ConstructionMachine", "AgriculturalVehicle", "ForkLiftTruck" ], "type": "string", "description": "Vehicle category.", "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." }, "model": { "title": "Model", "type": "string", "description": "Model or series name for the chosen Make, e.g. 320, X5, Golf, or a whole series like 3er. Requires a Make. An unknown model stops the run and lists valid names." }, "models": { "title": "Several makes / models", "type": "array", "description": "One search per entry, format Make|Model (for example BMW|3er or Audi|A4); Make alone searches the whole make. Each entry is capped at an equal share of Max listings. Search mode only.", "default": [], "items": { "type": "string" } }, "condition": { "title": "Condition", "enum": [ "", "NEW", "USED", "EMPLOYEES_CAR", "OLDTIMER", "DEMONSTRATION", "PRE_REGISTRATION" ], "type": "string", "description": "Vehicle condition.", "default": "" }, "fuels": { "title": "Fuel type(s)", "uniqueItems": true, "type": "array", "description": "Multi-select. Leave empty for any fuel.", "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.", "default": "" }, "transmissions": { "title": "Transmission(s) (multi-select)", "type": "array", "description": "Several gearbox types at once. Combined with the single transmission above when both are set.", "items": { "type": "string", "enum": [ "AUTOMATIC_GEAR", "MANUAL_GEAR", "SEMIAUTOMATIC_GEAR" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "bodyType": { "title": "Body type", "enum": [ "", "CABRIO", "ESTATECAR", "LIMOUSINE", "OFFROAD", "OTHERCAR", "SMALLCAR", "SPORTSCAR", "VAN" ], "type": "string", "description": "Body shape. Cars only.", "default": "" }, "bodyTypes": { "title": "Body type(s) (multi-select)", "type": "array", "description": "Several body types at once. Combined with the single body type above when both are set.", "items": { "type": "string", "enum": [ "CABRIO", "ESTATECAR", "LIMOUSINE", "OFFROAD", "OTHERCAR", "SMALLCAR", "SPORTSCAR", "VAN" ], "enumTitles": [ "Convertible", "Estate", "Saloon", "SUV / Off-road", "Other", "Small car", "Sports car / Coupe", "Van / Minibus" ] } }, "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.", "default": "DE" }, "zipcode": { "title": "Location (postal code or town)", "type": "string", "description": "Postal code or town in the chosen country (e.g. 10115 or München). Combine with Radius. A location that cannot be found stops the run with a message instead of searching the whole country." }, "radiusKm": { "title": "Radius around location (km)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Search radius around the location. Rounded up to the nearest radius the site offers (10, 20, 30, 40, 50, 60, 70, 100, 150, 200, 250, 300, 500, 1000 km). Ignored unless a location is set." }, "priceFrom": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Lower bound for price." }, "priceTo": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Upper bound for price." }, "yearFrom": { "title": "Minimum first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest first-registration year." }, "yearTo": { "title": "Maximum first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest first-registration year." }, "mileageFrom": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Lower bound for mileage." }, "mileageTo": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Upper bound for mileage." }, "powerFromKw": { "title": "Minimum power (kW)", "minimum": 0, "type": "integer", "description": "Lower bound for engine power in kW. 1 hp ~= 0.735 kW." }, "powerToKw": { "title": "Maximum power (kW)", "minimum": 0, "type": "integer", "description": "Upper bound for engine power in kW." }, "excludeDamaged": { "title": "Exclude damaged vehicles", "type": "boolean", "description": "Hide vehicles flagged as damaged.", "default": true }, "onlyDamaged": { "title": "Only damaged vehicles", "type": "boolean", "description": "Show ONLY vehicles flagged as damaged (overrides Exclude damaged).", "default": false }, "exteriorColors": { "title": "Exterior colour(s)", "uniqueItems": true, "type": "array", "description": "Multi-select. Leave empty for any colour.", "items": { "type": "string", "enum": [ "BLACK", "WHITE", "GREY", "SILVER", "BLUE", "RED", "GREEN", "BROWN", "BEIGE", "YELLOW", "GOLD", "ORANGE", "PURPLE" ], "enumTitles": [ "Black", "White", "Grey", "Silver", "Blue", "Red", "Green", "Brown", "Beige", "Yellow", "Gold", "Orange", "Purple" ] }, "default": [] }, "sellerType": { "title": "Seller type", "enum": [ "", "DEALER", "FSBO", "COMM_FSBO" ], "type": "string", "description": "Dealers, private sellers, or company vehicles.", "default": "" }, "priceRatings": { "title": "Price rating", "uniqueItems": true, "type": "array", "description": "Only listings the site rates at these price levels versus the market. Leave empty for any.", "items": { "type": "string", "enum": [ "VERY_GOOD_PRICE", "GOOD_PRICE", "REASONABLE_PRICE" ], "enumTitles": [ "Very good price", "Good price", "Fair price" ] }, "default": [] }, "onlineSinceDays": { "title": "Listed within", "enum": [ "", "1", "3", "7", "14" ], "type": "string", "description": "Only listings published within this many days.", "default": "" }, "vatReclaimable": { "title": "VAT reclaimable only", "type": "boolean", "description": "Only listings where VAT can be shown on the invoice (useful for businesses).", "default": false }, "minSeats": { "title": "Minimum seats", "minimum": 2, "maximum": 10, "type": "integer", "description": "Minimum number of seats (2-10)." }, "doors": { "title": "Doors", "enum": [ "", "TWO_OR_THREE", "FOUR_OR_FIVE", "SIX_OR_SEVEN" ], "type": "string", "description": "Number of doors.", "default": "" }, "maxPreviousOwners": { "title": "Maximum previous owners", "minimum": 1, "maximum": 4, "type": "integer", "description": "Up to this many previous owners (1-4)." }, "driveType": { "title": "Drive type", "enum": [ "", "ALL_WHEEL", "FRONT", "REAR" ], "type": "string", "description": "Which wheels are driven.", "default": "" }, "emissionClass": { "title": "Emission class", "enum": [ "", "EURO1", "EURO2", "EURO3", "EURO4", "EURO5", "EURO6", "EURO6C", "EURO6D_TEMP", "EURO6D", "EURO6E", "EURO7" ], "type": "string", "description": "Minimum emission standard.", "default": "" }, "minSellerRating": { "title": "Minimum seller rating", "minimum": 3, "maximum": 5, "type": "integer", "description": "Only sellers rated at least this many stars (3-5)." }, "keyword": { "title": "Keyword in description", "type": "string", "description": "Only listings whose description contains this text, e.g. panorama or Anhängerkupplung." }, "sortBy": { "title": "Sort order", "enum": [ "RELEVANCE", "PRICE_ASC", "PRICE_DESC", "FIRST_REGISTRATION_DESC", "FIRST_REGISTRATION_ASC", "MILEAGE_ASC", "MILEAGE_DESC", "CREATION_TIME", "CREATION_TIME_ASC" ], "type": "string", "description": "How results are ordered. In URL mode the order comes from the pasted link.", "default": "RELEVANCE" }, "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. Search links (search.html, with filters, sort order, a start page or another vehicle class), vehicle detail links, make/model pages such as /auto/audi-a4.html, fuel category pages such as /auto/elektro.html, body-type pages such as /auto/kombi.html and marketing landing pages such as /lp/audi-a4-angebote/, legacy /auto-inserat/ vehicle links and m.mobile.de links all work. Left untouched, URL mode scrapes the twelve example links.", "default": [ "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&ms=3500&s=Car&vc=Car", "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&ms=3500&s=Car&vc=Car&pageNumber=2", "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&ft=ELECTRICITY&isSearchRequest=true&ms=3500&od=down&s=Car&sb=p&vc=Car", "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&s=Motorbike&vc=Motorbike", "https://suchen.mobile.de/fahrzeuge/details.html?id=460410691", "https://suchen.mobile.de/auto/audi-a4.html", "https://suchen.mobile.de/auto/elektro.html", "https://suchen.mobile.de/auto/kombi.html", "https://m.mobile.de/fahrzeuge/details.html?id=449181583", "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&s=Van&vc=VanUpTo7500", "https://suchen.mobile.de/auto-inserat/x/459673664.html", "https://www.mobile.de/lp/bmw-3er-angebote/" ], "items": { "type": "string" } }, "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": false }, "reviewLimit": { "title": "Dealer reviews per listing", "minimum": 0, "maximum": 100, "type": "integer", "description": "With Fetch full vehicle detail on, also return the newest customer reviews of the listing's dealer (reviewer, rating, date, text, and friendliness, advice and response-time scores) in dealerReviews. 0 (the default when the field is omitted) turns reviews off; the Console form pre-fills 20. Private sellers have none. Each started block of 10 delivered reviews is billed as one detail-enrichment unit, on top of the detail charge for the listing.", "default": 0 }, "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 this many listings across the whole run. 0 means no limit. In incremental mode only listings that are returned count towards it.", "default": 20 }, "maxPages": { "title": "Maximum pages per search", "minimum": 0, "type": "integer", "description": "Optional page cap per search. Leave at 0 to let Maximum listings decide how much to collect; the actor never walks more than 1000 pages per search, and mobile.de itself shows at most 50 pages (about 1,000 listings) per search, so for very large searches split by model, price or location.", "default": 0 }, "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." }, "resumeFromRunId": { "title": "Resume a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue an interrupted collection. Listings already in that run's dataset are skipped, so they are neither returned nor charged again. Leave empty for a new collection; do not combine with recurring updates." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns all matching listings as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED listings, each marked with changeType (and changedFields for updates). Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those listings returned (and billed). A listing counts as UPDATED when any returned field changes (price, mileage, description, images, features, seller details and so on) except these, which never count: rating, reviewCount, sellerRecommendationRate, sellerAdRealityRate, sellerScore, sellerActiveRatingCount, sellerRecommendPercentage, sellerVehicleAsDescribedPercentage, priceRanges, dealerReviews, modifiedAt, renewedAt and listingType; add your own in \"Ignore fields when detecting changes\". Excluded fields are still returned. State is kept separately for each search setup; use State key when you want to name or deliberately share a monitoring campaign.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the mode, URLs and filter settings, so different searches never mix state with each other." }, "emitUnchanged": { "title": "Emit unchanged listings (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return listings that have not changed since the last run, marked UNCHANGED. This returns (and bills) extra rows you already have, so leave it off unless you want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired listings (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return listings that were present in a previous run but are no longer found, marked EXPIRED. Only produced when a run has scanned every result of every tracked search (all pages read, nothing cut short by Maximum listings or Maximum pages, no page that failed to load). This returns (and bills) extra rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Output field names that should NOT make a listing count as UPDATED. Always ignored: seller-level ratings (rating, reviewCount, sellerRecommendationRate, sellerAdRealityRate), which change for every listing of a dealer when one review arrives; modifiedAt and renewedAt, which move on dealer feed syncs and renewals; and listingType (the paid placement). Add fields such as description or images here if changes to them are not relevant to you. Ignored fields are still returned in the output.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }