Autoscout24 Scraper

Production-grade Apify Actor for scraping AutoScout24 vehicle listings across multiple European countries.

Features

• 🚗 Comprehensive Data Extraction: Scrapes all available vehicle data including specifications, features, pricing, seller info, and images
• 🌍 Multi-Country Support: Germany, Italy, France, Spain, Netherlands, Belgium, Austria, Luxembourg
• 🔍 Rich Filtering: Filter by make, model, price, year, mileage, fuel type, transmission, seller type, location
• 🛡️ Anti-Bot Resilience: Rotating user agents, viewports, human-like behavior, proxy support
• 📊 Structured Output: Clean, normalized JSON data ready for analysis
• ⚡ Scalable: Handles thousands of listings with automatic pagination
• 🔄 Fault Tolerant: Automatic retries, session management, graceful error handling

Input Configuration

Search Inputs

Parameter	Type	Description	Example
startUrls	array	Direct URLs to scrape	[{"url": "https://www.autoscout24.de/lst/bmw"}]
make	string	Car manufacturer	"bmw", "audi", "mercedes-benz"
model	string	Car model	"3-series", "a4"
priceMin	integer	Minimum price	5000
priceMax	integer	Maximum price	50000
yearMin	integer	Minimum year	2018
yearMax	integer	Maximum year	2024
mileageMin	integer	Minimum mileage (km)	0
mileageMax	integer	Maximum mileage (km)	100000
fuelType	string	Fuel type	"petrol", "diesel", "electric", "hybrid"
gearType	string	Transmission	"manual", "automatic"
sellerType	string	Seller type	"dealer", "private"
country	string	Country code	"de", "it", "fr", "es"
zipCode	string	ZIP/Postal code	"80331"
radius	integer	Search radius (km)	50, 100, 200
sortBy	string	Sort order	"price_asc", "age_desc"

Crawl Controls

Parameter	Type	Default	Description
maxResults	integer	100	Maximum listings to scrape (0 = unlimited)
maxPages	integer	10	Maximum pages to crawl (0 = unlimited)
maxConcurrency	integer	5	Parallel browser pages
scrapeDetails	boolean	true	Scrape full detail pages
detailPageOnly	boolean	false	Only scrape provided detail URLs
includePhoneNumber	boolean	false	Extract seller phone numbers
downloadImages	boolean	false	Download images to key-value store
headless	boolean	true	Run browser headlessly
debugMode	boolean	false	Enable verbose logging
maxRetries	integer	3	Max retries for failed requests
requestTimeout	integer	60	Page load timeout (seconds)

Proxy Configuration

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Example Inputs

Basic Search (BMW 3-Series in Germany)

{
  "make": "bmw",
  "model": "3-series",
  "country": "de",
  "priceMax": 30000,
  "yearMin": 2019,
  "maxResults": 50
}

Advanced Search with Filters

{
  "make": "audi",
  "model": "a4",
  "country": "de",
  "priceMin": 15000,
  "priceMax": 40000,
  "yearMin": 2018,
  "yearMax": 2023,
  "mileageMax": 80000,
  "fuelType": "diesel",
  "gearType": "automatic",
  "sellerType": "dealer",
  "zipCode": "80331",
  "radius": 100,
  "sortBy": "price_asc",
  "maxResults": 200
}

Direct URL Scraping

{
  "startUrls": [
    {
      "url": "https://www.autoscout24.de/lst/mercedes-benz/c-klasse?priceto=25000"
    }
  ],
  "maxResults": 100
}

Detail Pages Only

{
  "startUrls": [
    {
      "url": "https://www.autoscout24.de/angebot/mercedes-benz-c-klasse-uuid-here"
    }
  ],
  "detailPageOnly": true
}

Output Structure

Each scraped listing produces a JSON object with the following structure:

{
  "platform": "autoscout24",
  "listingId": "abc123-def456",
  "url": "https://www.autoscout24.de/angebot/...",
  "title": "BMW 320d xDrive Touring M Sport",
  "price": {
    "amount": 34990,
    "currency": "EUR",
    "gross": 34990,
    "net": 29403,
    "monthly": 399,
    "negotiable": false,
    "raw": "34.990 €"
  },
  "vehicle": {
    "make": "BMW",
    "model": "320d xDrive Touring",
    "variant": "M Sport",
    "condition": "Used",
    "year": 2021,
    "month": 6,
    "mileage": 45000,
    "mileageUnit": "km",
    "vin": "WBA...",
    "previousOwners": 1,
    "accidentFree": true
  },
  "specifications": {
    "power": { "kw": 140, "hp": 190 },
    "fuelType": "diesel",
    "transmission": "automatic",
    "driveType": "all-wheel",
    "consumption": { "combined": 5.2, "unit": "l/100km" },
    "emission": { "value": 137, "unit": "g/km" },
    "emissionClass": "Euro 6d",
    "doors": 5,
    "seats": 5,
    "color": "Mineral White",
    "interiorColor": "Black",
    "interiorMaterial": "Leather"
  },
  "features": [
    "Navigation Professional",
    "LED Headlights",
    "Parking Assistant",
    "Heated Seats",
    "Adaptive Cruise Control"
  ],
  "description": "Full dealer description text...",
  "highlights": ["Full service history", "Non-smoker vehicle"],
  "warranty": "12 months dealer warranty",
  "seller": {
    "type": "dealer",
    "name": "BMW Premium Selection München",
    "address": "Beispielstraße 123, 80331 München",
    "city": "München",
    "zip": "80331",
    "phone": "+49 89 12345678",
    "rating": 4.8,
    "reviewCount": 245,
    "website": "https://dealer-website.com",
    "dealerId": "12345"
  },
  "images": [
    "https://prod.pictures.autoscout24.net/...",
    "https://prod.pictures.autoscout24.net/..."
  ],
  "location": {
    "country": "DE",
    "city": "München",
    "zip": "80331",
    "region": "Bayern"
  },
  "meta": {
    "scrapedAt": "2026-01-23T12:00:00.000Z",
    "country": "DE",
    "crawlId": "abc12345",
    "source": "autoscout24",
    "promoted": false,
    "topListing": false
  }
}

Deployment

Apify Console

1. Create a new Actor in Apify Console
2. Connect your GitHub repository or upload the code
3. Build the Actor
4. Run with your desired input configuration

Apify CLI

# Install Apify CLI
npm install -g apify-cli

# Login
apify login

# Push to Apify
cd autoscout24-scraper
apify push

Local Testing

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows

# Install dependencies
pip install -r requirements.txt

# Install Playwright browsers
playwright install chromium

# Run locally
apify run --input-file=test_input.json

Cost Optimization Tips

1. Use scrapeDetails: false if you only need basic listing data
2. Set appropriate maxResults to limit unnecessary scraping
3. Use maxPages to control pagination depth
4. Lower maxConcurrency to reduce memory usage
5. Use RESIDENTIAL proxies for best success rate (worth the cost)
6. Enable downloadImages: false unless you need images stored

Blocking Troubleshooting

Common Issues

Issue	Solution
403 Errors	Use RESIDENTIAL proxy group
Captchas	Reduce concurrency, add delays
Empty pages	Check if URL format changed
Missing data	Enable debug mode, check selectors

Debug Mode

Enable debugMode: true to:

• Get verbose logging
• Save screenshots of each page
• Track selector failures

Proxy Recommendations

For best results, use:

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "countryCode": "DE"
  }
}

Supported Countries

Code	Country	Domain
de	Germany	autoscout24.de
it	Italy	autoscout24.it
fr	France	autoscout24.fr
es	Spain	autoscout24.es
nl	Netherlands	autoscout24.nl
be	Belgium	autoscout24.be
at	Austria	autoscout24.at
lu	Luxembourg	autoscout24.lu

Changelog

v1.0.0 (2026-01-23)

• Initial release
• Full listing and detail page extraction
• Multi-country support
• Anti-bot measures
• Proxy support

License

ISC License

Support

For issues or feature requests, please open an issue on GitHub or contact support.