{ "openapi": "3.0.1", "info": { "title": "Mobile.de Scraper", "description": "Mobile.de Scraper: Scrape used and new car listings from mobile.de and AutoScout24 (DE, AT, IT, FR, NL, BE, ES, LU) in one run: price, price rating, mileage, year, power, fuel, dealer, photos, full description and equipment.", "version": "0.1", "x-build-id": "rfZulbjfsDZblufH8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~mobile-de-autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-mobile-de-autoscout24-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/automly~mobile-de-autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-automly-mobile-de-autoscout24-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/automly~mobile-de-autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-automly-mobile-de-autoscout24-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": { "site": { "title": "Site", "enum": [ "both", "mobile.de", "autoscout24" ], "type": "string", "description": "Which site to search. With both, the results are shared evenly between the two.", "default": "both" }, "make": { "title": "Make", "type": "string", "description": "Car make, e.g. BMW, Volkswagen, Mercedes-Benz. Leave empty for every make." }, "model": { "title": "Model", "type": "string", "description": "Model or series of that make, e.g. 3 Series, 320, Golf, C-Class. Leave empty for every model." }, "priceMin": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Lowest asking price." }, "priceMax": { "title": "Price up to (EUR)", "minimum": 0, "type": "integer", "description": "Highest asking price." }, "yearMin": { "title": "First registration from (year)", "minimum": 0, "type": "integer", "description": "Earliest year of first registration, e.g. 2018." }, "yearMax": { "title": "First registration up to (year)", "minimum": 0, "type": "integer", "description": "Latest year of first registration." }, "mileageMin": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Lowest mileage in kilometres." }, "mileageMax": { "title": "Mileage up to (km)", "minimum": 0, "type": "integer", "description": "Highest mileage in kilometres." }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Only these fuel types (any of them). Leave empty for all.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid-petrol", "hybrid-diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (petrol/electric)", "Hybrid (diesel/electric)", "LPG", "Natural gas (CNG)", "Hydrogen", "Ethanol", "Other" ] } }, "transmission": { "title": "Transmission", "enum": [ "any", "manual", "automatic", "semi-automatic" ], "type": "string", "description": "Gearbox.", "default": "any" }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Only these body types (any of them). Leave empty for all. mobile.de has no transporter category among cars.", "items": { "type": "string", "enum": [ "small", "convertible", "coupe", "suv", "estate", "sedan", "van", "transporter", "other" ], "enumTitles": [ "Small car", "Convertible", "Coupe / sports car", "SUV / off-road / pickup", "Estate", "Sedan", "Van / minibus", "Transporter", "Other" ] } }, "powerMinKw": { "title": "Power from (kW)", "minimum": 0, "type": "integer", "description": "Lowest engine power in kW (1 kW = 1.36 hp)." }, "powerMaxKw": { "title": "Power up to (kW)", "minimum": 0, "type": "integer", "description": "Highest engine power in kW." }, "sellerType": { "title": "Seller", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealer or private listings.", "default": "any" }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter codes of the countries the cars are in, e.g. DE, AT, IT. Empty: AutoScout24 searches the country of the AutoScout24 site below, mobile.de every country. AutoScout24 covers DE, AT, BE, ES, FR, IT, LU, NL.", "items": { "type": "string" } }, "zipCode": { "title": "Postal code", "type": "string", "description": "Search around this postal code (in the first country above, or the AutoScout24 site's country). mobile.de searches by postal code in DE, FR, IT, PL and RO." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Distance around the postal code.", "default": 50 }, "autoscoutDomain": { "title": "AutoScout24 site", "enum": [ "de", "at", "it", "fr", "nl", "be", "es", "lu", "com" ], "type": "string", "description": "The AutoScout24 country site to read: its country is searched when Countries is empty, links point to it, and labels such as equipment come in its language. Each site shows its price rating for its own country's cars.", "default": "de" }, "sort": { "title": "Sort by", "enum": [ "relevance", "price-asc", "price-desc", "newest", "mileage-asc", "year-desc" ], "type": "string", "description": "Order the results are read in.", "default": "relevance" }, "startUrls": { "title": "Search or listing links", "type": "array", "description": "Optional: mobile.de or AutoScout24 search result links (filters set on the site) or listing links. Search links are read with their own filters. Listing links always come with full details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Open each listing for its full description, equipment, consumption and CO2, previous owners, accident-free, warranty and the dealer's address, phones and website. Charged as a detailed listing.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many listings to save in total for the whole run (all searches and both sites together).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The default works for most runs. If results come back empty, try a different proxy option.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }