# AutoScout24 Scraper — European Cars, Prices & Dealer Phones (`foxlabs/autoscout24-scraper`) Actor

Scrape European car listings from AutoScout24 across 8 EU countries. Extracts prices, AutoScout24 price ratings, mileage, kW/HP specs, WLTP emissions, and B2B dealer office & WhatsApp phone numbers.

- **URL**: https://apify.com/foxlabs/autoscout24-scraper.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 autoscout24 vehicle listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

<p align="center">
  <img src="https://img.shields.io/badge/Pay--Per--Event-%242.00_%2F_1K_Vehicles-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/8_EU_Markets-Prices_%C2%B7_VAT_%C2%B7_Dealer_Phones-2962FF?style=for-the-badge" alt="8 EU Markets" />&nbsp;
  <img src="https://img.shields.io/badge/AI_Agent_Ready-MCP_%26_x402-7C4DFF?style=for-the-badge" alt="MCP & x402 Ready" />&nbsp;
  <img src="https://img.shields.io/badge/Dual_Runtime-Batch_%2B_Standby_API-FF6D00?style=for-the-badge" alt="Batch + Standby API" />
</p>

## AutoScout24 Scraper — European Cars, Prices & Dealer Phones 🚀

**foXLabs European Commerce, Marketplace & B2B Lead Series:** [Amazon Best Sellers Scraper](https://apify.com/foxlabs/amazon-bestsellers-scraper) · [Yelp Business Leads Scraper](https://apify.com/foxlabs/yelp-business-scraper) · [Zillow Scraper](https://apify.com/foxlabs/zillow-scraper) · [Redfin Scraper](https://apify.com/foxlabs/redfin-scraper) · [Google Maps Leads](https://apify.com/foxlabs/google-maps-scraper)

🎉 Extract structured **European vehicle inventory, EUR prices, AutoScout24 algorithmic price-evaluation labels (`top-price`, `good-price`), VAT deductibility & net export prices, mileage, kW/HP power specs, WLTP consumption/CO₂ values, high-res gallery URLs and direct B2B car-dealer office & WhatsApp phone numbers** across **8 European countries** (`DE`, `AT`, `IT`, `NL`, `BE`, `FR`, `ES`, `LU`) — in **~3.3 seconds per 20 vehicles** on standard Datacenter proxies with **zero login**.

Built for cross-border EU automotive traders & exporters, dealership inventory/pricing SaaS platforms, fleet residual-value analysts, automotive B2B sales teams and vehicle-sourcing AI agents.

### 🔍 What is the AutoScout24 Scraper — and when should you use it?

AutoScout24 is Europe's largest pan-European automotive marketplace, spanning over two million active car listings across Germany, Italy, the Netherlands, Belgium, Austria, France, Spain and Luxembourg. Cross-border importers, used-car pricing desks and automotive B2B vendors depend on live AutoScout24 data to spot underpriced inventory (`priceLabel`), VAT-reclaimable export cars (`taxDeductible`, `netPriceEur`) and active commercial dealerships (`officePhone`, `whatsappPhone`).

This Actor turns any AutoScout24 search or offer URL into a clean **51-column automotive & dealer dataset** inside a lightweight `256 MB` HTTP runtime:

- **8-Country Structured Search, Custom `/lst/` URLs & Direct `/offers/` URLs** — filter by `makes`, `model`, `countries` (`D`, `A`, `I`, `NL`, `B`, `F`, `E`, `L`), `priceFromEur`/`priceToEur`, `yearFrom`, `maxMileageKm` and `sortBy`, or paste any localized `.com`/`.de`/`.it`/`.nl`/`.fr`/`.be`/`.at`/`.es` search URL (`searchUrls`) or offer link (`offerUrls`).
- **Instant Cross-Border Arbitrage Signals** — captures `priceEur`, AutoScout24's fair-market valuation badge (`priceLabel`: `"top-price"`, `"good-price"`, `"fair-price"`, `"somewhat-expensive"`, `"expensive"`), `mileageKm`, `firstRegistration`, `powerKw`, `powerHp`, `fuelType`, `transmission` and `wltpValues[]`.
- **Direct B2B Dealership Contact Intelligence** — extracts `sellerType` (`"Dealer"` vs. `"Private"`), `dealerId`, `dealerCompanyName`, `dealerContactName`, `dealerRatingStars`, `dealerRatingsCount`, street/ZIP/city address, **`officePhone` and `whatsappPhone`** right from search results!
- **Optional Deep Offer Enrichment (`enrichOfferDetails: true`)** — visits individual `/offers/` pages to add `taxDeductible` (MwSt. ausweisbar / VAT reclaimable), `netPriceEur` (net export price), `bodyType`, `bodyColor`, `doors`, `seats`, `engineDisplacementCcm` and full seller `description` at **zero extra PPE event surcharge**.

**Use it when you need:** real-time cross-border EU car arbitrage alerts; European car-dealership B2B cold outreach (`officePhone` + `whatsappPhone` + inventory size); residual-value depreciation modeling; or fleet EV/ICE pricing comparisons across EU countries.

**Use something else when:** you need **VIN history decoding or government license-plate inspection registries** (AutoScout24 listings publish technical specifications, price evaluations and dealer contacts rather than private chassis VINs unless written in the seller's free-text `description`).

### 🤖 Use with AI agents (MCP, Claude, Cursor & x402)

**Already connected to the Apify MCP server?** Ask your AI assistant to call `foxlabs/autoscout24-scraper`.

- **Hosted MCP URL (zero install):** `https://mcp.apify.com?tools=foxlabs/autoscout24-scraper`
- **Local stdio config (Claude Desktop, Cursor, Cline, Windsurf):**

```json
{
  "mcpServers": {
    "autoscout24-scraper": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "foxlabs/autoscout24-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

**Your agent can pay for its own runs.** Billed at a flat **$0.002 per unique `listing`** (`$2.00 / 1,000`, diagnostic `status` rows `$0.00`), this Actor supports autonomous agentic micropayments via **x402 (USDC on Base)** or **Skyfire** as well as standard Apify tokens.

Copy-paste prompt for Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
Use the Apify Actor `foxlabs/autoscout24-scraper` to search European car listings, price evaluation ratings, VAT export status and dealership phone/WhatsApp contacts across 8 EU countries.

Input fields:
- `makes`: array of brand slugs (e.g. ["bmw", "porsche", "mercedes-benz", "audi", "volkswagen", "tesla"])
- `model`: optional model slug paired with the first make (e.g. "3-series", "911", "golf")
- `countries`: array from ["D", "A", "I", "NL", "B", "F", "E", "L"] (D=Germany, A=Austria, I=Italy, NL=Netherlands, B=Belgium, F=France, E=Spain, L=Luxembourg)
- `searchUrls`: optional array of https://www.autoscout24.com/lst/... (or .de/.it/.nl/.fr) URLs
- `offerUrls`: optional array of direct /offers/... or /angebote/... URLs
- `priceFromEur` / `priceToEur`: integer EUR range (0 = any)
- `yearFrom`: minimum registration year (0 = any, e.g. 2020)
- `maxMileageKm`: maximum mileage in km (0 = any, e.g. 80000)
- `sortBy`: "standard" | "price_asc" | "price_desc" | "age" | "mileage_asc"
- `enrichOfferDetails`: boolean (default false) — adds VAT deductibility, netPriceEur, doors/seats, color & full description
- `maxListingsPerSearch`: integer 1..400 (default 20)

Start with:
{"makes":["porsche"],"model":"911","countries":["D","NL"],"yearFrom":2020,"maxMileageKm":60000,"sortBy":"price_asc","enrichOfferDetails":true,"maxListingsPerSearch":20}
```

**Things you can ask your AI agent:**

- *"Find the 20 cheapest 2020+ Porsche 911 listings under 60,000 km across Germany (`D`) and the Netherlands (`NL`) with `enrichOfferDetails: true`, and highlight any cars rated `top-price` or `good-price` with deductible VAT (`taxDeductible: true`)."*
- *"Build a B2B lead list of German and Austrian BMW/Mercedes dealerships including `dealerCompanyName`, `dealerContactName`, `officePhone`, `whatsappPhone` and `dealerRatingStars`."*
- *"Compare median asking prices (`priceEur`) of 2022 Tesla Model Y cars in Germany (`D`), Italy (`I`) and France (`F`)."*

The machine-readable Actor summary, MCP metadata and schema live at `https://apify.com/foxlabs/autoscout24-scraper.md`.

### 📋 Overview

Everything needed for pan-European vehicle sourcing, residual-value modeling and dealership B2B prospecting — in one 51-column dataset.

| Property | Details |
|---|---|
| **Public data source** | Public AutoScout24 search & vehicle pages across 8 EU domains |
| **Supported EU markets** | Germany (`D`), Austria (`A`), Italy (`I`), Netherlands (`NL`), Belgium (`B`), France (`F`), Spain (`E`), Luxembourg (`L`) |
| **Authentication required** | None — zero AutoScout24 account, dealer login or cookies |
| **Container footprint** | Lightweight `256 MB` HTTP runtime (**3.3s** for 20 listings on verified QA) |
| **Output row types (`rowType`)** | `listing` (`$0.002` / `$2.00 per 1,000`), `status` (`$0.00` diagnostic) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`as24:<listingId>`) across multi-country sweeps & restarts |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`GET /`, `POST /scrape`) |

**Why automotive traders & B2B teams pick this Actor:**

- 📞 **Dealer `officePhone` + `whatsappPhone` on search speed** — captures dealership company name, contact person, star rating, street/ZIP address, landline phone and WhatsApp number directly from search payloads in seconds.
- 💶 **Algorithmic `priceLabel` + VAT Net Export Price** — filter immediately for `"top-price"` / `"good-price"` bargains and enrich `taxDeductible` + `netPriceEur` for cross-border EU/non-EU export margin calculations.
- ⚡ **Flat `$2.00 / 1,000` even with `enrichOfferDetails: true`** — runs cleanly on standard Datacenter proxies with zero per-event surcharge for `/offers/` detail enrichment.
- 🌍 **Any regional AutoScout24 URL accepted** — paste URLs from `autoscout24.de`, `autoscout24.it`, `autoscout24.nl`, `autoscout24.fr`, `autoscout24.be`, `autoscout24.at`, `autoscout24.es` or `autoscout24.com`.

### ✨ Key Features

- 🚗 **Full Technical & Powertrain Normalization** — Extracts numeric `powerKw`, `powerHp`, `powerText`, `engineDisplacementCcm`, `mileageKm`, `firstRegistration`, `fuelType`, `transmission`, `bodyType`, `bodyColor`, `doors`, `seats`, `isDamaged`, `isNew` and `wltpValues[]`.
- 🏷️ **Newest-Listed Arbitrage Mode (`sortBy: "age"`)** — Poll every 5–15 minutes with `sortBy: "age"` to catch newly listed underpriced dealer trade-ins before rival buyers call.
- 🖼️ **High-Resolution `1280x960` WebP Image Arrays** — Captures clean `images[]` arrays and `imageCount` for marketplace syndication or computer-vision damage/trim grading.
- 🔌 **Dual Batch + Synchronous Standby HTTP (`POST /scrape`)** — Ready for real-time valuation tools, WhatsApp sourcing bots, Clay and n8n.

### 🎬 Quick Start (API & Standby HTTP)

**1. Synchronous Batch API call (returns JSON array directly):**

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~autoscout24-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"makes":["bmw"],"model":"3-series","countries":["D"],"yearFrom":2019,"maxListingsPerSearch":20}'
```

**2. Real-time Standby HTTP API (`POST /scrape`):**

```bash
curl -X POST "https://foxlabs--autoscout24-scraper.apify.actor/scrape?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"makes":["porsche"],"model":"911","countries":["D"],"sortBy":"age","maxListingsPerSearch":10}'
```

### 🚀 Getting Started (3 steps)

1. **Pick brands, countries or paste AutoScout24 URLs** — Choose `makes` (`["bmw"]`), optional `model` (`"3-series"`) and `countries` (`["D", "NL"]`), or paste any custom filtered `searchUrls` / `offerUrls`.
2. **Set price, year & mileage bounds** — Configure `priceFromEur`/`priceToEur`, `yearFrom`, `maxMileageKm`, `sortBy` (`"age"` for newest listings, `"price_asc"` for cheapest) and optional `enrichOfferDetails: true`.
3. **Run & export** — Click **Start** and download 67-column vehicle & dealership data in JSON, CSV, Excel or Parquet.

### 📥 Input & Filters

```json
{
  "makes": ["bmw"],
  "model": "3-series",
  "countries": ["D", "AT"],
  "searchUrls": [],
  "offerUrls": [],
  "priceFromEur": 15000,
  "priceToEur": 45000,
  "yearFrom": 2020,
  "yearTo": 2025,
  "maxMileageKm": 90000,
  "fuelType": "diesel",
  "transmission": "automatic",
  "bodyType": "sedan",
  "sortBy": "price_asc",
  "enrichOfferDetails": true,
  "maxListingsPerSearch": 40
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `makes` | `array<string>` | `["bmw"]` | Car brand slugs (`"bmw"`, `"mercedes-benz"`, `"audi"`, `"porsche"`, `"volkswagen"`, `"tesla"`). Empty = all makes. |
| `model` | `string` | `"3-series"` | Optional model slug paired with the first make (`"3-series"`, `"911"`, `"a4"`, `"golf"`, `"c-class"`). |
| `countries` | `array<string>` | `["D"]` | EU country codes: `D` (DE), `A` (AT), `I` (IT), `NL`, `B` (BE), `F` (FR), `E` (ES), `L` (LU). Empty = all EU. |
| `searchUrls` | `array<string>` | `[]` | Custom filtered AutoScout24 `/lst/...` URLs (`.com`, `.de`, `.it`, `.nl`, `.fr`, `.be`, `.at`, `.es`). |
| `offerUrls` | `array<string>` | `[]` | Direct `/offers/...` or `/angebote/...` vehicle URLs (automatically enriches full offer details). |
| `priceFromEur` / `priceToEur` | `integer` | `0` / `0` | Optional EUR price floor and ceiling (`0` = no limit). |
| `yearFrom` / `yearTo` | `integer` | `0` / `0` | Optional minimum and maximum first-registration year (`0` = any year, e.g. `2020`–`2025`). |
| `maxMileageKm` | `integer` | `0` | Maximum odometer mileage in kilometers (`0` = any mileage, e.g. `100000`). |
| `fuelType` | `string` | `"any"` | `"any"`, `"gasoline"`, `"diesel"`, `"electric"`, `"hybrid_gasoline"`, `"hybrid_diesel"`, `"lpg"`, `"cng"`. |
| `transmission` | `string` | `"any"` | `"any"`, `"automatic"`, `"manual"`, or `"semi_automatic"`. |
| `bodyType` | `string` | `"any"` | `"any"`, `"sedan"`, `"suv"`, `"station_wagon"`, `"compact"`, `"coupe"`, `"convertible"`, `"van"`, `"transporter"`. |
| `sortBy` | `string` | `"standard"` | `"standard"`, `"price_asc"`, `"price_desc"`, `"age"` (newest listings first), or `"mileage_asc"`. |
| `enrichOfferDetails` | `boolean` | `true` | Fetch each `/offers/` detail page for full `equipment[]`, `taxDeductible`, `netPriceEur`, `emissionClass`, `driveTrain`, `previousOwners`, `hasFullServiceHistory`, `warrantyMonths`, `latitude`/`longitude` & full `description`. |
| `maxListingsPerSearch` | `integer` | `20` | Maximum vehicles collected per brand/search URL (`1`–`400`). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically via standard Apify Proxy. |

**Copy-paste input recipes:**

- **Real-time cross-border EU export arbitrage (`sortBy: "age"`, VAT + full equipment enriched):**
  `{"makes":["porsche","mercedes-benz"],"model":"","countries":["D","NL","B"],"yearFrom":2021,"transmission":"automatic","sortBy":"age","enrichOfferDetails":true,"maxListingsPerSearch":30}`
- **Custom multi-filter AutoScout24 URL (`searchUrls` — e.g. quattro/xDrive, panoramic roof, LED):**
  `{"makes":[],"model":"","searchUrls":["https://www.autoscout24.de/lst/audi/a6?fregfrom=2021&cy=D&ustate=N%2CU"],"enrichOfferDetails":true,"maxListingsPerSearch":50}`
- **Fast B2B German/Austrian dealership phone & WhatsApp directory (`enrichOfferDetails: false`):**
  `{"makes":["volkswagen","audi","bmw"],"model":"","countries":["D","A"],"enrichOfferDetails":false,"maxListingsPerSearch":100}`

### 📤 Output Schema & Real Sample Record

Each item carries `rowType` (`"listing"` or free diagnostic `"status"`), `detailsEnriched` (`boolean`), and deterministic `rowKey` (`as24:<listingId>`).

| Field Group | Fields (67 Columns Total) |
|---|---|
| **Vehicle Identity** | `rowKey`, `rowType`, `listingId`, `crossReferenceId`, `url`, `make`, `model`, `modelGroup`, `variant`, `title`, `subtitle`, `offerType`, `isNew`, `isDamaged`, `detailsEnriched`, `scrapedAt` |
| **Pricing, Arbitrage & VAT** | `priceEur`, `priceFormatted`, `priceLabel` (`top-price`..`expensive`), `taxDeductible` *(detail)*, `netPriceEur` *(detail)* |
| **Powertrain, Emissions & History** | `mileageKm`, `firstRegistration`, `fuelType`, `transmission`, `driveTrain`, `powerKw`, `powerHp`, `powerText`, `engineDisplacementCcm`, `cylinders`, `gears`, `emptyWeightKg`, `bodyType`, `bodyColor`, `doors`, `seats`, `previousOwners`, `hasFullServiceHistory`, `nonSmokingVehicle`, `nextInspectionDate`, `warrantyMonths`, `emissionClass`, `emissionSticker`, `co2EmissionsGkm`, `fuelConsumptionCombined`, `wltpValues[]`, `equipment[]` |
| **Dealership, GPS & B2B Contacts** | `sellerType`, `dealerId`, `dealerCompanyName`, `dealerContactName`, `dealerRatingStars`, `dealerRatingsCount`, `dealerInfoUrl`, `officePhone`, `whatsappPhone`, `countryCode`, `postalCode`, `city`, `street`, `latitude`, `longitude` |
| **Media & Seller Notes** | `imageCount`, `images[]`, `description` *(detail)*, `searchOrigin` |

#### Real sample record (from verified platform pre-publish run `9ZcnSz6wd98VWvawe`, 2026-11-14)

```json
{
  "rowKey": "as24:7c983ea0-ceae-4b8d-851e-d1d994df2408",
  "rowType": "listing",
  "listingId": "7c983ea0-ceae-4b8d-851e-d1d994df2408",
  "crossReferenceId": "53541949203904",
  "title": "BMW 320",
  "subtitle": "I Touring*",
  "url": "https://www.autoscout24.com/offers/bmw-320-i-touring-gasoline-black-cat_ma13mo1641-7c983ea0-ceae-4b8d-851e-d1d994df2408",
  "make": "BMW",
  "model": "320",
  "modelGroup": "3 Series",
  "variant": "Touring",
  "offerType": "U",
  "isNew": false,
  "priceEur": 2900,
  "priceFormatted": "€ 2,900",
  "priceLabel": "somewhat-expensive",
  "taxDeductible": null,
  "netPriceEur": null,
  "mileageKm": 231883,
  "firstRegistration": "05/2007",
  "fuelType": "Gasoline",
  "transmission": "Manual",
  "powerText": "110 kW (150 hp)",
  "powerKw": 110,
  "powerHp": 150,
  "engineDisplacementCcm": 1995,
  "bodyType": null,
  "bodyColor": null,
  "doors": null,
  "seats": null,
  "isDamaged": false,
  "wltpValues": [
    "7.6 l/100 km (comb.)",
    "182 g/km (comb.)"
  ],
  "countryCode": "DE",
  "postalCode": "49393",
  "city": "Lohne (Old)",
  "street": "Vechtaer Str. 60",
  "sellerType": "Dealer",
  "dealerId": "3936329",
  "dealerCompanyName": "Autohaus Refhat GmbH",
  "dealerContactName": "Refhat Albagare",
  "dealerRatingStars": 4,
  "dealerRatingsCount": 97,
  "dealerInfoUrl": "https://www.autoscout24.com/dealerinfo/autohaus-refhat-gmbh?atype=C",
  "officePhone": "+49 (0)444 - 28882022",
  "whatsappPhone": "+49 (0)4442 - 7097570",
  "imageCount": 15,
  "images": [
    "https://prod.pictures.autoscout24.net/listing-images/7c983ea0-ceae-4b8d-851e-d1d994df2408_fa9d48e0-35bb-4dfa-b84b-2fd1009dc54a.jpg/1280x960.webp"
  ],
  "detailsEnriched": false,
  "scrapedAt": "2026-11-14T05:07:46.210Z"
}
```

Every run also writes a `SOURCE_REPORT` telemetry summary to the default Key-Value Store.

### 🧪 Data Quality — Measured

Verified on the Apify platform across QA runs (`I04ewh5HR2XhtfoQz`, `oULb5Jg2gVYuSj34T`) and pre-publish live billing verification (`9ZcnSz6wd98VWvawe` on 2026-11-14):

- **100% cross-country listing uniqueness:** Verified across multi-country (`DE`, `AT`, `NL`) paginated sweeps (`40/40` unique vehicles, `0` duplicates via `as24:<listingId>`).
- **Direct dealer phone & WhatsApp extraction on search tier:** Commercial dealer listings populate `dealerCompanyName`, `officePhone` and `whatsappPhone` directly on fast search runs without even requiring detail-page visits.
- **Verified PPE billing accuracy:** Settled `chargedEventCounts` on run `9ZcnSz6wd98VWvawe` matched `listing` rows `1:1`, and diagnostic `status` rows (`oULb5Jg2gVYuSj34T`) billed `$0.00`.

### ⏱️ Performance — Measured

Measured on the Apify platform at the default **`256 MB`** memory tier:

- **3.3 seconds for 20 German BMW listings:** Platform QA run `I04ewh5HR2XhtfoQz` (`makes: ["bmw"]`, `model: "3-series"`, `countries: ["D"]`, `maxListingsPerSearch: 20`) finished in **`3.3s`** on standard Datacenter proxies inside `256 MB` RAM.
- **Restart-idempotent Dataset tracking:** Container restarts automatically skip any `as24:<listingId>` already written to the Dataset.

### 💼 Use Cases

1. **Cross-Border EU Vehicle Sourcing & Export Arbitrage**
   - *Input:* `{"makes":["bmw","audi","porsche"],"model":"","countries":["D","NL","B"],"yearFrom":2021,"sortBy":"age","enrichOfferDetails":true,"maxListingsPerSearch":40}`
   - *Output:* Newly listed vehicles with `priceLabel` (`"top-price"` / `"good-price"`), `taxDeductible: true`, `netPriceEur`, and instant dealer `whatsappPhone`.
   - *Business action:* Message the dealer on WhatsApp within minutes of listing publication with exact net-of-VAT export numbers in hand.

2. **Automotive SaaS & Warranty B2B Dealership Prospecting**
   - *Input:* Sweep `100–400` listings per region across Germany (`D`), Austria (`A`), Italy (`I`) and Spain (`E`).
   - *Output:* Deduplicated commercial dealers (`dealerId`, `dealerCompanyName`, `dealerContactName`, `street`, `postalCode`, `city`, `officePhone`, `whatsappPhone`, `dealerRatingStars`).
   - *Business action:* Build verified European Autohaus / concessionnaire CRM lists for DMS software, financing, transport or warranty sales.

3. **OEM & Fleet Residual-Value Depreciation Curves**
   - *Input:* Weekly scheduled runs across EV and hybrid models (`tesla`, `volkswagen`, `hyundai`, `byd`) across 8 EU markets.
   - *Output:* `priceEur` vs. `mileageKm` and `firstRegistration` cohorts segmented by `countryCode`.
   - *Business action:* Track EV residual value divergence between Northern Europe (`NL`/`DE`) and Southern Europe (`IT`/`ES`).

4. **AI Car-Buyer Concierge Agents (MCP / Standby)**
   - *Input:* Synchronous `POST /scrape` call filtering family wagons or EVs under `€30,000` and `60,000 km`.
   - *Output:* Ranked cars with `priceLabel`, `powerHp`, `wltpValues`, photos and direct `/offers/` links.
   - *Business action:* Power consumer car-buying assistants with live European dealer inventory.

### 🔗 Integrations (Node.js, Python, n8n, Make & Clay)

#### JavaScript / Node.js (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('foxlabs/autoscout24-scraper').call({
    makes: ['bmw'],
    model: '3-series',
    countries: ['D', 'NL'],
    yearFrom: 2020,
    maxMileageKm: 80000,
    sortBy: 'price_asc',
    enrichOfferDetails: true,
    maxListingsPerSearch: 25,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} AutoScout24 vehicles`, items[0]);
```

#### Python (`apify-client` v3)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("foxlabs/autoscout24-scraper").call(
    run_input={
        "makes": ["bmw"],
        "model": "3-series",
        "countries": ["D"],
        "yearFrom": 2020,
        "sortBy": "price_asc",
        "maxListingsPerSearch": 25,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item["rowType"] == "listing":
        print(item["title"], item["priceEur"], "EUR |", item["priceLabel"], "|", item["whatsappPhone"] or item["officePhone"])
```

*(Written for `apify-client` v3 where `call()` returns a `Run` object exposing `run.default_dataset_id`; on `apify-client` v1/v2 use `run["defaultDatasetId"]`.)*

#### n8n, Make, Zapier & Clay

- **5-minute WhatsApp/Telegram car-deal sniper (n8n / Make):** Schedule every 10 minutes with `sortBy: "age"` → filter rows where `priceLabel` is `"top-price"` or `"good-price"` → push photo, `priceEur`, `mileageKm` and clickable `whatsappPhone` link to Telegram/Slack.

### 📊 Pricing (Pay-Per-Event)

Transparent single-event **Pay-Per-Event (PPE)** pricing — optional `/offers/` detail enrichment (`enrichOfferDetails: true`) is included at **no extra event fee**:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `listing` | Once per unique AutoScout24 vehicle record delivered (`rowType: "listing"`) | **$0.002** | **$2.00 / 1,000** |
| `status` *(diagnostic)* | Empty input, malformed URL, or zero-match filter note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **100 vehicles with prices, specs & dealer phones (`enrichOfferDetails: false`):** `100 × $0.002` = **$0.20**
- **100 vehicles enriched with VAT status, net export price & full description (`enrichOfferDetails: true`):** `100 × $0.002` = **$0.20**
- **1,000 cross-border European vehicle listings:** `1,000 × $0.002` = **$2.00**

**Billing guarantees:**

- **Proxy traffic included:** Runs fast on standard Apify Proxy included inside `$0.002` per listing.
- **Zero duplicate charges:** Multi-country or overlapping URL batches deduplicate automatically via `as24:<listingId>`.
- **Hard spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` halts cleanly when reached. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including zero-result runs.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need an AutoScout24 dealer login, API key, or residential proxies?

No. All 8 European AutoScout24 country markets (`DE`, `AT`, `IT`, `NL`, `BE`, `FR`, `ES`, `LU`) are collected keylessly on standard Datacenter proxies managed automatically inside the Actor — zero dealership accounts, session cookies, API approvals or external proxy subscriptions required from you.

#### Which fields require `enrichOfferDetails: true` vs. `enrichOfferDetails: false`?

Even with `enrichOfferDetails: false` (default, ~3.3s for 20 cars), you already get `priceEur`, `priceLabel`, `mileageKm`, `firstRegistration`, `powerKw`, `powerHp`, `fuelType`, `transmission`, `wltpValues`, `images[]`, `dealerCompanyName`, `dealerContactName`, street/ZIP/city address, `officePhone` and `whatsappPhone`. Enable `enrichOfferDetails: true` (still `$0.002`/car, just one extra HTTP request per vehicle) when you also need `taxDeductible` (VAT status), `netPriceEur`, `bodyType`, `bodyColor`, `doors`, `seats` and the seller's full free-text `description`.

#### How do I use `searchUrls` for ultra-specific equipment filters (e.g., panoramic roof, adaptive cruise, heat pump, AWD)?

Configure any combination of equipment checkboxes, interior trims, emission classes or radius filters directly in your browser on `autoscout24.com`, `autoscout24.de`, `autoscout24.it`, `autoscout24.nl` or `autoscout24.fr`, copy the `/lst/...` URL from your address bar, and paste it into `searchUrls` (setting `"makes": []` and `"model": ""` if you only want that custom search URL).

#### Why does AutoScout24 cap any single search query at `400` listings (`20` pages × `20` cars)?

AutoScout24's search pagination serves a maximum of `20` pages (`400` vehicles) per query URL. To extract thousands of vehicles for a popular brand like BMW or Volkswagen across Germany, partition your queries by `yearFrom` cohorts, `priceFromEur`/`priceToEur` brackets (for example `10000–20000`, `20001–30000`), or individual `model` slugs — `as24:<listingId>` deduplication ensures zero duplicate vehicles across slices.

#### What values appear in AutoScout24's `priceLabel` valuation field?

AutoScout24 benchmarks every vehicle against comparable EU market listings of the same make, model, trim, year, power and mileage, assigning labels such as `"top-price"` (deeply below market), `"good-price"`, `"fair-price"`, `"somewhat-expensive"`, `"expensive"` or `null` (when insufficient comps exist, e.g., rare classics or brand-new configurations).

#### How do `taxDeductible` and `netPriceEur` help cross-border car exporters?

Commercial fleet and leasing returns in Germany (`MwSt. ausweisbar`), the Netherlands (`BTW-auto`) and Belgium often qualify for net-of-VAT B2B intra-EU or non-EU export invoicing. When `enrichOfferDetails: true` (or `offerUrls`) is used on VAT-eligible vehicles, `taxDeductible` is `true` and `netPriceEur` provides the exact net export price excluding national VAT (e.g. excluding 19% German MwSt.).

#### Are private-seller phone numbers extracted alongside commercial dealer phones?

Commercial dealerships (`sellerType: "Dealer"`) publish `dealerCompanyName`, `dealerContactName`, `officePhone` and often `whatsappPhone` publicly on their listings, which this Actor extracts cleanly. Private individual sellers (`sellerType: "Private"`) typically communicate only via AutoScout24's in-app messaging form and do not expose public phone numbers (`officePhone: null`).

#### What do the 1- and 2-letter codes in `countries` stand for?

AutoScout24 uses standard European license-plate country codes in its search filter: `"D"` = Germany, `"A"` = Austria, `"I"` = Italy, `"NL"` = Netherlands, `"B"` = Belgium, `"F"` = France, `"E"` = Spain, and `"L"` = Luxembourg. Leave `countries: []` empty if you want to search across all 8 EU countries simultaneously.

#### How does `model` interact when I list multiple brands in `makes`?

Because model slugs (`"3-series"`, `"911"`, `"golf"`) belong to a specific manufacturer, `model` applies when searching the matching first brand in `makes`. When sweeping multiple brands in one run (`makes: ["bmw", "audi", "mercedes-benz"]`), set `"model": ""` or pass exact brand+model URLs inside `searchUrls`.

#### Can I enrich specific `offerUrls` without running brand searches?

Yes. Pass `"makes": [], "model": "", "countries": []` alongside `"offerUrls": ["https://www.autoscout24.com/offers/..."]` (or `.de/angebote/...` links). Direct `offerUrls` automatically populate all detail-level VAT, body and description fields.

#### Can AI agents and n8n workflows query this Actor synchronously?

Yes. Connect via `https://mcp.apify.com?tools=foxlabs/autoscout24-scraper` for MCP tool calling in Claude or Cursor, or send synchronous `POST /scrape` requests to `https://foxlabs--autoscout24-scraper.apify.actor/scrape` in Apify Standby mode.

#### Is the Actor safe against duplicate rows and repeat billing on container restarts?

Yes. At startup, the Actor inspects the active run's default Dataset, loads all previously persisted `as24:<listingId>` keys into memory, and skips any vehicle already delivered before a container migration or restart — guaranteeing 100% Dataset uniqueness and zero duplicate per-event charges.

### 🐛 Troubleshooting

- **`taxDeductible`, `netPriceEur`, `bodyType` and `doors` are `null`:** You ran fast search mode (`enrichOfferDetails: false`). Set `"enrichOfferDetails": true` (no extra PPE charge) to fetch `/offers/` detail pages.
- **Default `"bmw"` / `"3-series"` ran alongside `searchUrls` or `offerUrls`:** Set `"makes": []` and `"model": ""` when running URL-only inputs.
- **Zero results when searching multiple `makes` with `"model": "3-series"`:** Clear `"model": ""` when searching non-BMW brands!
- **Stopped at 400 cars on a broad brand query:** Slice by `priceFromEur`/`priceToEur` or `yearFrom` to paginate beyond AutoScout24's 20-page per-query window.

### 🚧 What It Does Not Do

- Does **not** log into dealer portals, send AutoScout24 lead messages, or reveal hidden private-seller phone numbers.
- Does **not** decode closed government motor-vehicle VIN history databases.

### ⚠️ Trademark Notice

This Actor is an independent software tool developed by **foXLabs** and is not affiliated with, endorsed by, or sponsored by AutoScout24 GmbH. "AutoScout24" is a registered trademark of AutoScout24 GmbH, used strictly to identify compatibility with publicly accessible web pages.

### ⚖️ Is It Legal to Scrape Public AutoScout24 Listings?

This Actor reads publicly accessible vehicle advertisements and commercial dealership contact details published for public discovery — with zero login, zero authentication bypass and zero private consumer data collected. Ensure B2B outreach to dealerships complies with applicable EU ePrivacy, GDPR and national telemarketing rules (such as German UWG §7).

### 🤝 Support, Custom Data & Contact

- 🌐 **Website & full portfolio:** [data.foxlabs.com.tr](https://data.foxlabs.com.tr)
- 📧 **Custom data & enterprise inquiries:** info@foxlabs.com.tr
- 🐛 **Bug reports & feature requests:** open an issue in the Actor's **Issues** tab on Apify Store (include your Run ID)
- 🧰 **Browse all foXLabs Actors:** [apify.com/foxlabs](https://apify.com/foxlabs)

### Changelog

#### 0.1.3 (2026-11-14)

- Enriched dataset from `51` to `67` columns (`equipment[]`, `emissionClass`, `emissionSticker`, `co2EmissionsGkm`, `fuelConsumptionCombined`, `driveTrain`, `cylinders`, `gears`, `emptyWeightKg`, `previousOwners`, `hasFullServiceHistory`, `nonSmokingVehicle`, `nextInspectionDate`, `warrantyMonths`, `latitude`, `longitude`) and added `yearTo`, `fuelType`, `transmission`, and `bodyType` filters.

#### 0.1.2 (2026-11-14)

- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent configuration, Standby HTTP `POST /scrape` examples, verified QA & PPE billing metrics, worked cost tables, and expanded 12-question FAQ.

#### 0.1.0 (2026-11-13)

- Initial release of `foxlabs/autoscout24-scraper` supporting 8 EU markets, `/lst/` search URLs, `/offers/` detail enrichment (`taxDeductible`, `netPriceEur`), `priceLabel` arbitrage ratings, B2B dealer office & WhatsApp phones, and Batch + Standby HTTP modes.

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/autoscout24-scraper/changelog.md

# Actor input Schema

## `makes` (type: `array`):

Car brand slugs to search on AutoScout24 (e.g. 'bmw', 'mercedes-benz', 'audi', 'porsche', 'volkswagen', 'tesla'). Leave empty to search all makes.

## `model` (type: `string`):

Optional model slug paired with the first make (e.g. '3-series', '911', 'a4', 'golf', 'c-class').

## `countries` (type: `array`):

AutoScout24 country codes: D (Germany), A (Austria), I (Italy), NL (Netherlands), B (Belgium), F (France), E (Spain), L (Luxembourg). Leave empty for all EU.

## `searchUrls` (type: `array`):

Optional custom filtered AutoScout24 search URLs (https://www.autoscout24.com/lst/... or regional .de/.it/.nl/.fr domains).

## `offerUrls` (type: `array`):

Optional direct AutoScout24 vehicle detail URLs (/offers/... or /angebote/...).

## `priceFromEur` (type: `integer`):

Optional minimum price in EUR (0 = no minimum).

## `priceToEur` (type: `integer`):

Optional maximum price in EUR (0 = no maximum).

## `yearFrom` (type: `integer`):

Optional minimum registration year (e.g. 2018). Set 0 for any year.

## `yearTo` (type: `integer`):

Optional maximum registration year (e.g. 2025). Set 0 for any year.

## `maxMileageKm` (type: `integer`):

Optional maximum mileage in kilometers (e.g. 100000). Set 0 for any.

## `fuelType` (type: `string`):

Optional powertrain/fuel filter.

## `transmission` (type: `string`):

Optional gearbox type filter.

## `bodyType` (type: `string`):

Optional vehicle body style filter.

## `sortBy` (type: `string`):

Listing sort order.

## `enrichOfferDetails` (type: `boolean`):

Visits each vehicle's /offers/ page to extract full equipment\[], VAT deductibility, net export price, Euro emission class, CO2, drivetrain, owners/service history, warranty, dealer GPS coordinates, and full seller description.

## `maxListingsPerSearch` (type: `integer`):

Maximum vehicles to extract per make/search URL (1–400).

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Runs on standard Datacenter proxies by default.

## Actor input object example

```json
{
  "makes": [
    "bmw"
  ],
  "model": "3-series",
  "countries": [
    "D"
  ],
  "searchUrls": [],
  "offerUrls": [],
  "priceFromEur": 0,
  "priceToEur": 0,
  "yearFrom": 0,
  "yearTo": 0,
  "maxMileageKm": 0,
  "fuelType": "any",
  "transmission": "any",
  "bodyType": "any",
  "sortBy": "standard",
  "enrichOfferDetails": true,
  "maxListingsPerSearch": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

## `report` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "makes": [
        "bmw"
    ],
    "model": "3-series",
    "countries": [
        "D"
    ],
    "maxListingsPerSearch": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "makes": ["bmw"],
    "model": "3-series",
    "countries": ["D"],
    "maxListingsPerSearch": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/autoscout24-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "makes": [
    "bmw"
  ],
  "model": "3-series",
  "countries": [
    "D"
  ],
  "maxListingsPerSearch": 20
}' |
apify call foxlabs/autoscout24-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/autoscout24-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Y79QCIFaAEgyk8Fax/builds/ebhKqaqO4gJoyWghP/openapi.json
