# AutoScout24 Scraper — Dealer Contacts & Price Rating (`nikse77/autoscout24-scraper`) Actor Extract car listings from AutoScout24 across 9 European markets (IT, DE, AT, ES, FR, BE, NL, LU, .com). Get prices with market evaluation, full specs, dealer contacts and ratings. Fast HTTP scraping — no browser needed. Automatically bypasses the 4,000-result search limit. - **URL**: https://apify.com/nikse77/autoscout24-scraper.md - **Developed by:** [A L](https://apify.com/nikse77) (community) - **Categories:** Automation, Developer tools, Lead generation - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 listings 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 ## AutoScout24 Scraper — All Countries, Dealer Contacts & Price Rating ### What does AutoScout24 Scraper do? This Actor extracts **car listings from [AutoScout24](https://www.autoscout24.com)**, Europe's largest online car marketplace, across **9 markets**: Italy, Germany, Austria, Spain, France, Belgium, Netherlands, Luxembourg and the pan-European `.com` domain. For every listing you get the **price with AutoScout24's own market evaluation** (super price → high price), full vehicle specs, **dealer contact details including phone numbers and WhatsApp**, seller ratings, location and photo URLs in high resolution — extracted via fast HTTP requests (no browser), which keeps runs quick and cheap. Running on the Apify platform gives you API access, scheduling, webhooks, integrations (Google Sheets, Make, Zapier, LangChain), proxy rotation and run monitoring out of the box. ### Why scrape AutoScout24? - **Price intelligence** — track used-car prices by make, model, year and country; spot deals flagged as "super price" the minute they appear. - **Dealer lead generation** — build lists of dealerships with company name, contact person, phone and WhatsApp numbers, ratings and location. - **Cross-border arbitrage** — compare the same model across Italian, German, French or Spanish markets. - **Market research & AI agents** — feed clean, structured JSON to dashboards, ML models or LLM agents. ### How to scrape AutoScout24 1. Open the Actor and click **Try for free**. 2. Either paste one or more **AutoScout24 search URLs** (any country domain), or pick a **country, make and model** and optional price/year/mileage filters. 3. Set **Max listings** and click **Start**. 4. Download the dataset as **JSON, CSV, Excel or HTML**, or read it via API. ### Input Two ways to define what to scrape: - **Start URLs** — any AutoScout24 search results URL, e.g. `https://www.autoscout24.it/lst/fiat/panda?atype=C` - **Filters** — country, make, model, price range (EUR), first-registration years, max mileage ```json { "country": "it", "make": "Fiat", "model": "Panda", "priceTo": 10000, "maxItems": 500 } ```` #### ✨ Bypass the 4,000-results limit AutoScout24 only serves the first **200 pages (~4,000 results)** of any search. When your search matches more, this Actor **automatically splits it into price bands** and crawls each band separately, so you can extract *all* matching listings — tens of thousands if needed. Enabled by default (`splitLargeSearches`). ### Output One JSON object per listing. Example (shortened): ```json { "id": "8493b413-5ca8-4298-8ee9-4c79c90d4ef0", "url": "https://www.autoscout24.it/annunci/fiat-panda-1-2-69cv-e6-lounge-...", "make": "Fiat", "model": "Panda", "modelVersion": "FIAT Panda 1.2 69cv E6 Lounge ANNO 2016", "offerType": "used", "price": 5290, "priceFormatted": "€ 5.290", "priceRating": 1, "priceRatingLabel": "super price", "mileageKm": 104000, "firstRegistration": "10/2016", "transmission": "Manuale", "fuel": "Benzina", "powerKw": 51, "powerHp": 69, "sellerType": "Dealer", "sellerCompany": "MS Automobili Srl", "sellerContactName": "Matteo Ciuffreda", "sellerPhones": [{ "type": "Mobile", "number": "+393409097048" }], "sellerWhatsapp": "+39 347 - 9149374", "sellerRatingStars": 4.5, "sellerRatingCount": 516, "city": "Torino - To", "countryCode": "IT", "images": ["https://prod.pictures.autoscout24.net/listing-images/....webp"], "imagesLarge": ["https://prod.pictures.autoscout24.net/listing-images/..../1280x960.webp"] } ``` #### Main data fields | Field | Description | | --- | --- | | `price`, `priceRating`, `priceRatingLabel` | Price in EUR plus AutoScout24's market evaluation (1 = super price … 5 = high price) | | `make`, `model`, `modelVersion`, `subtitle` | Vehicle identity and equipment highlights | | `mileageKm`, `firstRegistration`, `fuel`, `transmission`, `powerKw`, `powerHp`, `engineDisplacementCcm` | Technical specs, parsed to clean numbers | | `sellerCompany`, `sellerContactName`, `sellerPhones`, `sellerWhatsapp` | Dealer contacts, ready for CRM import | | `sellerRatingStars`, `sellerRatingCount` | Seller reputation | | `countryCode`, `zip`, `city`, `street` | Location | | `images`, `imagesLarge` | Photo URLs (thumbnail and 1280×960) | ### How much does it cost to scrape AutoScout24? Pricing is **pay-per-event**: a small fee per Actor start plus a fee per listing scraped. You are only charged for **unique listings actually saved** — duplicates are filtered out for free. A typical 1,000-listing run completes in well under a minute. ### Tips - Keep **Max listings** close to what you need — you pay per result. - Use narrower searches (make + model + country) for the fastest runs. - Schedule the Actor daily and connect a webhook to catch newly listed cars or price drops. - Data quality note: `priceRating` comes directly from AutoScout24's price evaluation engine. ### FAQ & disclaimers **Is it legal to scrape AutoScout24?** This Actor extracts publicly available data only. Note that results may include personal data (e.g. dealer contact names and phone numbers); make sure you have a legitimate basis to process it under GDPR and use the data responsibly. You are responsible for complying with applicable laws and the target site's terms. **A search returns fewer results than shown on the site?** Enable `splitLargeSearches` (on by default) to bypass the 4,000-results serving limit. **Found a bug or missing field?** Open an issue in the **Issues** tab — feedback is usually addressed within days. Custom solutions available on request. # Actor input Schema ## `startUrls` (type: `array`): AutoScout24 search result URLs from any country domain (e.g. https://www.autoscout24.it/lst/fiat/panda?atype=C). If provided, the filters below are ignored for these URLs. ## `country` (type: `string`): AutoScout24 market to search when building the search from filters. ## `make` (type: `string`): Car make, e.g. "Fiat", "Mercedes-Benz". Leave empty to search all makes. ## `model` (type: `string`): Car model, e.g. "Panda". Requires Make to be set. ## `priceFrom` (type: `integer`): Minimum price in EUR. ## `priceTo` (type: `integer`): Maximum price in EUR. ## `yearFrom` (type: `integer`): Earliest first-registration year, e.g. 2015. ## `yearTo` (type: `integer`): Latest first-registration year. ## `mileageTo` (type: `integer`): Maximum mileage in kilometers. ## `maxItems` (type: `integer`): Maximum number of listings to scrape. You are only charged for unique listings actually saved to the dataset. ## `splitLargeSearches` (type: `boolean`): AutoScout24 only serves the first ~4,000 results of any search (200 pages). When enabled, searches exceeding the limit are automatically split into price bands so you can retrieve all matching listings. ## `proxyConfiguration` (type: `object`): Proxies to use. Apify automatic proxies are recommended. ## Actor input object example ```json { "country": "it", "make": "Fiat", "model": "Panda", "maxItems": 100, "splitLargeSearches": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "make": "Fiat", "model": "Panda", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("nikse77/autoscout24-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 = { "make": "Fiat", "model": "Panda", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("nikse77/autoscout24-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 '{ "make": "Fiat", "model": "Panda", "proxyConfiguration": { "useApifyProxy": true } }' | apify call nikse77/autoscout24-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nikse77/autoscout24-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper — Dealer Contacts & Price Rating", "description": "Extract car listings from AutoScout24 across 9 European markets (IT, DE, AT, ES, FR, BE, NL, LU, .com). Get prices with market evaluation, full specs, dealer contacts and ratings. Fast HTTP scraping — no browser needed. Automatically bypasses the 4,000-result search limit.", "version": "0.1", "x-build-id": "xzTXrahfVPR2Y5faK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nikse77~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nikse77-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/nikse77~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-nikse77-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/nikse77~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-nikse77-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "AutoScout24 search result URLs from any country domain (e.g. https://www.autoscout24.it/lst/fiat/panda?atype=C). If provided, the filters below are ignored for these URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "it", "de", "at", "es", "fr", "be", "nl", "lu", "eu" ], "type": "string", "description": "AutoScout24 market to search when building the search from filters.", "default": "it" }, "make": { "title": "Make", "type": "string", "description": "Car make, e.g. \"Fiat\", \"Mercedes-Benz\". Leave empty to search all makes." }, "model": { "title": "Model", "type": "string", "description": "Car model, e.g. \"Panda\". Requires Make to be set." }, "priceFrom": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in EUR." }, "priceTo": { "title": "Price to (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in EUR." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "type": "integer", "description": "Earliest first-registration year, e.g. 2015." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "type": "integer", "description": "Latest first-registration year." }, "mileageTo": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometers." }, "maxItems": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Maximum number of listings to scrape. You are only charged for unique listings actually saved to the dataset.", "default": 100 }, "splitLargeSearches": { "title": "Bypass the 4,000-results limit", "type": "boolean", "description": "AutoScout24 only serves the first ~4,000 results of any search (200 pages). When enabled, searches exceeding the limit are automatically split into price bands so you can retrieve all matching listings.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. Apify automatic proxies are recommended.", "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 } } }, "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 } } } } } } } } } } ```