{ "openapi": "3.0.1", "info": { "title": "Mobile.de Scraper", "description": "Scrape vehicle listings from Mobile.de, Germany's largest car marketplace. Get make, model, price, mileage, registration, power, fuel, transmission, equipment and photos, plus the dealer name, phone, address and exact GPS on every listing. Search by URL or filters and export to JSON, CSV or Excel.", "version": "1.0", "x-build-id": "oRPx2CAcPCsAXugfQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~mobile-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-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/silentflow~mobile-de-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-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/silentflow~mobile-de-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-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": { "searchUrls": { "title": "Search or listing URLs", "type": "array", "description": "Mobile.de search result URLs or individual listing URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchCategory": { "title": "Vehicle category", "enum": [ "Car", "Motorbike", "VanUpTo7500", "TruckOver7500", "SemiTrailerTruck", "Motorhome", "ConstructionMachine", "Trailer" ], "type": "string", "description": "Type of vehicle to search for.", "default": "Car" }, "models": { "title": "Makes and models", "type": "array", "description": "Filter by make and model. Use the mobile.de make id, optionally with a model id, e.g. \"3500\" (BMW) or \"3500|20\" (BMW 3 Series).", "items": { "type": "string" } }, "priceMin": { "title": "Minimum price (€)", "minimum": 0, "type": "integer", "description": "Lowest price to include." }, "priceMax": { "title": "Maximum price (€)", "minimum": 0, "type": "integer", "description": "Highest price to include." }, "mileageKmMin": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Lowest mileage to include." }, "mileageKmMax": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Highest mileage to include." }, "registrationYearMin": { "title": "Minimum registration year", "minimum": 1900, "type": "integer", "description": "Earliest first-registration year." }, "registrationYearMax": { "title": "Maximum registration year", "minimum": 1900, "type": "integer", "description": "Latest first-registration year." }, "fuelType": { "title": "Fuel type", "type": "array", "description": "Filter by fuel type.", "items": { "type": "string", "enum": [ "PETROL", "DIESEL", "ELECTRICITY", "HYBRID", "HYBRID_DIESEL", "LPG", "CNG", "HYDROGENIUM", "ETHANOL" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (petrol)", "Hybrid (diesel)", "LPG", "CNG", "Hydrogen", "Ethanol" ] } }, "sort": { "title": "Sort results", "enum": [ "relevance", "price-asc", "price-desc", "mileage-asc", "mileage-desc", "date", "registration-desc" ], "type": "string", "description": "Order of the results.", "default": "relevance" }, "maxItems": { "title": "Maximum number of results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The maximum number of listings to collect.", "default": 50 }, "includeDetails": { "title": "Collect full details", "type": "boolean", "description": "Fetch each listing's full record (description, equipment, all photos, technical attributes). Turn off for faster, lighter results.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Enable only if you run very large jobs.", "default": { "useApifyProxy": false } }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Show detailed logs.", "default": false } } }, "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 } } } } } } } } } }