{ "openapi": "3.0.1", "info": { "title": "mobile.de Scraper", "description": "A mobile.de scraper that returns vehicle listings with the asking price and its currency, the mileage and its unit, the first registration, power, fuel, the VAT disclosure, the seller and the site's own verdict on whether the price is fair. No login, no API key, no browser.", "version": "0.1", "x-build-id": "BYI94oVRo2Kqqs3TL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~mobile-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-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/s-r~mobile-de-scraper/runs": { "post": { "operationId": "runs-sync-s-r-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/s-r~mobile-de-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-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": { "query": { "title": "Search text", "type": "string", "description": "Free text searched across the listing, for example \"audi tts\" or \"vw golf gti\". Leave it empty to walk the whole market with the filters below." }, "url": { "title": "Search URL", "type": "string", "description": "A mobile.de search URL to read instead of building one from the fields below. Apply whatever filters you want on the site, then paste the resulting address here. Anything the site can filter on works this way, including make and model." }, "vehicle_category": { "title": "Vehicle category", "enum": [ "car", "motorbike", "motorhome", "van", "truck", "trailer" ], "type": "string", "description": "Which part of the marketplace to search. Cars is the default; the other categories use the same result layout.", "default": "car" }, "price_min": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lower asking-price bound in euros. mobile.de quotes every listing in euros." }, "price_max": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Upper asking-price bound in euros." }, "year_min": { "title": "Earliest registration year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only vehicles first registered in or after this year. New vehicles have no registration date and are excluded when this is set." }, "mileage_max": { "title": "Maximum mileage", "minimum": 0, "type": "integer", "description": "Upper odometer bound in kilometres." }, "power_min_kw": { "title": "Minimum power (kW)", "minimum": 0, "type": "integer", "description": "Lower engine-power bound in kilowatts. 147 kW is 200 metric horsepower." }, "fuel": { "title": "Fuel type", "enum": [ "any", "petrol", "diesel", "electric", "hybrid_petrol", "hybrid_diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "type": "string", "description": "Restrict to one fuel type. Each option was checked by reading the fuel field back off the returned vehicles.", "default": "any" }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "New vehicles, used vehicles, or both. New vehicles carry a fuel-consumption and CO2 figure but no mileage or registration date.", "default": "any" }, "damaged_only": { "title": "Damaged vehicles only", "type": "boolean", "description": "Return only vehicles the seller has declared damaged or accident-involved. Useful for salvage and parts buyers.", "default": false }, "sort": { "title": "Sort", "enum": [ "relevance", "price_asc", "price_desc", "mileage_asc", "first_registration_desc" ], "type": "string", "description": "Result order. Only orders whose effect is visible in the returned rows are offered here; mobile.de accepts other sort tokens and ignores them.", "default": "relevance" }, "include_paid_placements": { "title": "Include paid placements", "type": "boolean", "description": "mobile.de mixes paid slots into the result list. They are excluded by default; switch this on to receive them, tagged in the placement field.", "default": false }, "limit": { "title": "Maximum listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many vehicles to return, 1 to 1000. A page carries 20 organic results and the walk stops at the real end of the result set rather than probing past it.", "default": 40 }, "retries": { "title": "Retries per page", "minimum": 1, "maximum": 8, "type": "integer", "description": "Retry attempts per page, each one a differently shaped client. Raise it if a run reports pages that were refused.", "default": 4 } } }, "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 } } } } } } } } } }