{
"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": "pJqEy0AiJGTvMpwau"
},
"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"
}
}
}
},
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "Keywords to search mobile.de for, one per line, like tesla model 3, golf gti or sportback. Each term is a search of its own, matched against the listing titles and texts the way the mobile.de search box does, and combined with the filters below (category, makes, price, mileage, year, fuel, sort).",
"items": {
"type": "string"
}
},
"listingIds": {
"title": "Listing ids",
"type": "array",
"description": "Mobile.de listing ids, one per line, like 453303025: the number at the end of a listing URL. Each id returns the full record of that listing. A listing URL pasted here works too.",
"items": {
"type": "string"
}
},
"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
},
"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
}
}
}
}
}
}
}
}
}
}