# Autohero Scraper: 10 EU Stores, 40+ Fields (`getascraper/autohero-cars-scraper`) Actor Pull inspected used cars from Autohero across 10 EU storefronts. 40+ fields per car: accidents, damages, previous owners, service book, VAT, branch, emissions. Filter by country, brand, model, sort. $1.99/1k. No proxy needed. - **URL**: https://apify.com/getascraper/autohero-cars-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 eu cars This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Autohero Cars Scraper: All Europe Used Cars Catalog Get the full used car inventory from Autohero in 10 European countries, in clean data you can use. No setup, no manual work. One run gives you 23,000+ inspected cars. Autohero (AUTO1 Group) sells inspected used cars online across Germany, Austria, Spain, France, Belgium, Italy, Netherlands, Poland, and Sweden. This scraper pulls the live inventory for any combination of countries. 40+ fields per car including accident history, previous owners, service records, and dealer branch details. --- ### What can you do with it? * **You are a cross-border trader** moving cars between EU markets. Spot price gaps between Germany, France, and Italy. The same car can be 20% cheaper in one country. * **You are a market researcher** building European-wide reports. Compare prices, mileage, and brand mix across all 10 countries. Build a single dataset for the whole EU. * **You are a finance or insurance provider.** Get clean vehicle history for any car: accident count, damage count, previous owners, service book status. Quote policies or approve loans with confidence. * **You are a fleet manager** sourcing vehicles. Get bulk data on every sedan, SUV, or compact available across Europe. Filter by year, mileage, and price. * **You are a dealership in one country** watching competitors in another. Track what Autohero is selling in adjacent markets to adjust your pricing. --- ### How to use it 1. **Open the actor** in the Apify Store and click "Try for free". 2. **Pick your countries.** Choose one or many from the 10 European storefronts (Germany, Austria, Spain, France, Belgium, Italy, Netherlands, Poland, Sweden). 3. **Set your volume.** Define how many cars to extract per country (e.g. 500 each). 4. **Click Start.** The scraper pulls the live data in minutes. 5. **Download your dataset** in JSON, CSV, or Excel. Or pipe it straight to Google Sheets, BigQuery, or your CRM. --- ### Input | Field | Type | Required | Description | | --- | --- | :---: | --- | | `locales` | array of enum | No | Country storefronts: de (Germany), at (Austria), es (Spain), fr (France), fr-be (Belgium French), nl-be (Belgium Dutch), it (Italy), nl (Netherlands), pl (Poland), se (Sweden). | | `startUrls` | array of URLs | No | Optional direct Autohero car detail page URLs. | | `maxItems` | integer | No | Maximum cars to extract per country. Default 1000. | | `pageLimit` | integer | No | Batch size per query (1 to 100). Default 100. | | `maxConcurrency` | integer | No | Parallel requests. Default 6. | | `proxyConfiguration` | object | No | Optional residential proxy. Default: no proxy. | --- ### Output Each row is one car. Here is what a real record looks like: ```json { "rowType": "car", "vehicleId": "522d03e4-2b6a-4a4f-a4c6-c05f3ce05a40", "stockNumber": "UN54418", "retailAdId": "673ccc64-21da-4404-8455-462e9ed7b359", "locale": "de", "countryCode": "IT", "detailUrl": "https://www.autohero.com/de/peugeot-308/id/522d03e4-2b6a-4a4f-a4c6-c05f3ce05a40/", "title": "Peugeot 308 1.5 Blue-HDi", "make": "Peugeot", "model": "308", "trim": "1.5 Blue-HDi", "builtYear": 2022, "firstRegistrationYear": 2023, "firstRegistration": "20230228T000000.000Z", "mileageKm": 50781, "priceAmount": 19799, "priceCurrency": "EUR", "monthlyPaymentAmount": 315, "monthlyPaymentCurrency": "EUR", "fuelType": "Diesel", "transmission": "Automatic", "driveTrain": "front-wheel", "powerKw": 96, "powerHp": 131, "engineCcm": 1499, "acceleration0to100": 10.6, "co2Value": 119, "emissionClass": "EURO 3544", "vatType": "VAT deductible", "previousOwners": 1, "accidents": 0, "damages": 42, "hasServiceBook": false, "lastServiceOn": "20260513", "dealerName": "Workshop Pizzale", "dealerCity": "Voghera", "dealerZipcode": "27058", "dealerStreet": "via Torquato Taramelli", "mainImageUrl": "https://img-eu-c1.autohero.com/img/0fefdadc9865110119ed20c05ead250ed4e8b8ef71c226b71b3a9d59765b7bec/exterior/1/768x432-468e7dc428934aa59f22d8dfd5b4c071.jpg", "scrapedAt": "2026-06-16T13:00:15.123Z" } ```` You can download the dataset in JSON, CSV, or Excel. Prices are in local currency (EUR for most countries). *** ### Data table | Field | Type | Description | | --- | :---: | --- | | `vehicleId` | text | Autohero's internal unique vehicle ID. | | `stockNumber` | text | Dealer stock number. | | `locale` | text | Country code: de, at, es, fr, it, etc. | | `countryCode` | text | Country of registration. | | `title` | text | Full car title with model and trim. | | `make` | text | Manufacturer: Peugeot, BMW, Audi, etc. | | `model` | text | Model: 308, X3, A4, etc. | | `trim` | text | Trim level. | | `builtYear` | integer | Year of manufacture. | | `firstRegistrationYear` | integer | First registration year. | | `firstRegistration` | text | First registration date (ISO 8601). | | `mileageKm` | integer | Odometer reading in kilometers. | | `priceAmount` | integer | Listed price in local currency. | | `priceCurrency` | text | Price currency: EUR, etc. | | `monthlyPaymentAmount` | integer | Monthly finance payment in local currency. | | `monthlyPaymentCurrency` | text | Monthly payment currency. | | `fuelType` | text | Petrol, Diesel, Electric, Hybrid. | | `transmission` | text | Automatic or Manual. | | `driveTrain` | text | Front-wheel, rear-wheel, all-wheel drive. | | `powerKw` | integer | Engine power in kilowatts. | | `powerHp` | integer | Engine power in horsepower. | | `engineCcm` | integer | Engine displacement in cc. | | `acceleration0to100` | number | 0-100 km/h time in seconds. | | `co2Value` | integer | CO2 emissions in g/km. | | `emissionClass` | text | Emission standard: EURO 6, EURO 5, etc. | | `vatType` | text | VAT treatment for business buyers. | | `previousOwners` | integer | Number of previous owners. | | `accidents` | integer | Number of recorded accidents. | | `damages` | integer | Number of recorded damages. | | `hasServiceBook` | boolean | True if the service book is complete. | | `lastServiceOn` | text | Date of last service. | | `dealerName` | text | Delivery branch name. | | `dealerCity` | text | Branch city. | | `dealerZipcode` | text | Branch zip code. | | `dealerStreet` | text | Branch street address. | | `mainImageUrl` | text | Cover image URL. | | `detailUrl` | text | Canonical Autohero URL. | | `scrapedAt` | text | ISO timestamp of when the data was extracted. | *** ### Pricing **$1.99 per 1,000 listings.** No monthly fee. You only pay for what you extract. The 10 countries combined have roughly 23,000 cars in stock, which would cost about $46 in a single full run. *** ### Tips and advanced options - **Start with one country** to test, then expand. Germany has the most inventory (around 8,000 cars). Italy and France are next. - **Use `maxItems: 100` for a quick preview** of the schema, then bump to 1000 or 2000 for full data dumps. - **Set `pageLimit: 100`** for the fastest runs. Lower values like 25 will make more API calls but give you more granular progress. - **Compare across countries** by running multiple locales in sequence. The same car model can have a 15-25% price gap between Germany and Eastern Europe. - **Schedule daily runs** via Apify Schedules to track inventory turnover and price changes. *** ### FAQ **Is scraping Autohero legal?** This actor extracts publicly visible car listings that anyone can see without logging in. You are responsible for ensuring your use case complies with Autohero's Terms of Service and applicable laws. Do not scrape private data beyond what is publicly displayed. **Why is the data so clean?** Autohero runs on a modern backend with structured data, so every listing has consistent fields: accident count, service book status, dealer branch, emissions, finance options. No messy HTML scraping. **Can I get data from one specific country only?** Yes. Set the `locales` array to a single country code, e.g. `["de"]` for Germany or `["fr"]` for France. **How does the free trial work?** New Apify users get $5 of platform credit. That is enough to extract about 2,500 cars across the 10 countries, or 23,000 cars for a full run if you top up. *** ### Disclaimers and support - **Disclaimer**: This actor is not affiliated with Autohero, AUTO1 Group, or any of their partners. The data is publicly available on the website. Make sure your usage complies with Autohero's terms of service and applicable laws. - **Support**: Open an issue from the [Issues tab](https://apify.com/actorstack/autohero-cars-scraper/issues) for bug reports or feature requests. Custom enterprise solutions with regional catalog filters, CSV exports, or API integrations are also available. # Actor input Schema ## `locales` (type: `array`): Select the countries you want to scrape used cars from (e.g. Germany, France, Spain). Each country has its own catalog. ## `startUrls` (type: `array`): Optional. Enter direct links to specific car pages on Autohero to extract just those vehicles. ## `brand` (type: `string`): Optional. Filter results by a specific brand (e.g., BMW, Peugeot, Audi, Volkswagen). Capitalized first letter is required. ## `model` (type: `string`): Optional. Filter results by a specific model name (e.g., 308, Golf, 500, A-Klasse). ## `sortBy` (type: `string`): Select how you want the saved listings to be ordered. ## `maxItems` (type: `integer`): The maximum number of cars to save for each selected country. ## `pageLimit` (type: `integer`): The number of results retrieved in each background step. Best left at the default of 100. ## `maxConcurrency` (type: `integer`): Number of parallel queries allowed. Default of 6 is recommended for optimal performance. ## `maxRequestRetries` (type: `integer`): Number of automatic retries on temporary connection hiccups. ## `proxyConfiguration` (type: `object`): Proxy settings. Recommended default settings are preconfigured to guarantee smooth, unblocked access. ## Actor input object example ```json { "locales": [ "de" ], "startUrls": [], "brand": "", "model": "", "sortBy": "newest", "maxItems": 1000, "pageLimit": 100, "maxConcurrency": 6, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "locales": [ "de" ], "startUrls": [], "brand": "", "model": "", "sortBy": "newest", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/autohero-cars-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locales": ["de"], "startUrls": [], "brand": "", "model": "", "sortBy": "newest", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/autohero-cars-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "locales": [ "de" ], "startUrls": [], "brand": "", "model": "", "sortBy": "newest", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call getascraper/autohero-cars-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/autohero-cars-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Autohero Scraper: 10 EU Stores, 40+ Fields", "description": "Pull inspected used cars from Autohero across 10 EU storefronts. 40+ fields per car: accidents, damages, previous owners, service book, VAT, branch, emissions. Filter by country, brand, model, sort. $1.99/1k. No proxy needed.", "version": "0.1", "x-build-id": "kPVznZG6UMOh6rNgX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~autohero-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-autohero-cars-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/getascraper~autohero-cars-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-autohero-cars-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/getascraper~autohero-cars-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-autohero-cars-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": [ "locales", "maxItems" ], "properties": { "locales": { "title": "Storefront Countries", "type": "array", "description": "Select the countries you want to scrape used cars from (e.g. Germany, France, Spain). Each country has its own catalog.", "default": [ "de" ], "items": { "type": "string" } }, "startUrls": { "title": "Direct Car Page Links", "type": "array", "description": "Optional. Enter direct links to specific car pages on Autohero to extract just those vehicles.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "brand": { "title": "Brand / Manufacturer", "type": "string", "description": "Optional. Filter results by a specific brand (e.g., BMW, Peugeot, Audi, Volkswagen). Capitalized first letter is required.", "default": "" }, "model": { "title": "Model Name", "type": "string", "description": "Optional. Filter results by a specific model name (e.g., 308, Golf, 500, A-Klasse).", "default": "" }, "sortBy": { "title": "Sort Results By", "enum": [ "newest", "price_asc", "price_desc", "mileage_asc", "mileage_desc" ], "type": "string", "description": "Select how you want the saved listings to be ordered.", "default": "newest" }, "maxItems": { "title": "Maximum Cars to Save", "minimum": 1, "type": "integer", "description": "The maximum number of cars to save for each selected country.", "default": 1000 }, "pageLimit": { "title": "Batch Size", "minimum": 1, "maximum": 100, "type": "integer", "description": "The number of results retrieved in each background step. Best left at the default of 100.", "default": 100 }, "maxConcurrency": { "title": "Search Speed", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of parallel queries allowed. Default of 6 is recommended for optimal performance.", "default": 6 }, "maxRequestRetries": { "title": "Retry Count", "minimum": 0, "type": "integer", "description": "Number of automatic retries on temporary connection hiccups.", "default": 5 }, "proxyConfiguration": { "title": "Network Proxy Settings", "type": "object", "description": "Proxy settings. Recommended default settings are preconfigured to guarantee smooth, unblocked access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```