🚗 AutoScout24.com Vehicle Scraper Actor

Automatically extract detailed and structured vehicle listings from AutoScout24.com — complete with specifications, seller info, pricing, and media.

---

🌟 What Does This Do?

This powerful Apify actor automates the process of scraping comprehensive vehicle data from AutoScout24.com. It efficiently:

1. Visits AutoScout24 search result URLs you provide.
2. Navigates through multiple pages to find all available vehicle listings.
3. Extracts complete details for each listing, including:
   • 🆔 Listing ID, URL, Ad creation date, and status (active/inactive)
   • 🚘 Vehicle Information: Make, Model, Year, Version, Body Type, Power (HP), Transmission, Fuel Type, CO₂ emissions
   • 💲 Price Data: formatted price, numeric EUR value, negotiation status, VAT deduction
   • 🛣️ Mileage, First registration date, Service history, and Accident status
   • ⚙️ Technical Specs: Cylinders, Gears, Drive Train, Weight, Doors, Seats
   • 🎛️ Equipment: Comfort, Safety, Entertainment, Extras (each counted and categorized)
   • 📍 Location Data: Country, City, ZIP, Street, Latitude/Longitude
   • 👤 Seller Info: Dealer name, contact person, phone, type, homepage, warranty
   • 🖼️ Media: Main image, all image URLs, image count, 360° availability
   • 🧾 Description: Full text (cleaned and HTML-free)
   • ⚙️ Metadata: Offer type, Ad tier, MIA status, total equipment count

---

🛠️ Configuration Made Simple

Provide these input fields in JSON when running the actor:

1. Start URLs (start_urls)

   • List of AutoScout24 search or vehicle URLs.
   • (Example: https://www.autoscout24.com/lst/bmw/1-series/all?sort=age&desc=1)
   • Input format:

     [{ "url": "https://www.autoscout24.com/lst/bmw/1-series/all?sort=age&desc=1" }]
     

2. Start Page (start_page) (Optional)

   • The page number to start scraping from.
   • (Default: 1)

3. End Page (end_page) (Optional)

   • Page number to stop scraping at.
   • (Use this to limit pagination.)

4. Max Concurrency (max_concurrency)

   • Number of parallel listing page workers.
   • (Default: 100)

5. Custom Proxy URL (proxy_url) (Optional)

   • Use a custom proxy.
   • (If not provided, Apify’s proxy will be used.)

---

🚦 Advanced Features

• Automatic Pagination: Automatically detects and navigates to next pages until no new listings appear.
• Duplicate & Stagnation Detection: Stops gracefully when listings repeat or pages are empty.
• Concurrent Workers: Separate workers for listing and detail scraping to improve efficiency.
• Resumable State: Saves scraping progress under STATEKEY = "AUTOSCOUT24_SCRAPER_STATE".
• Telegram Notifications: Send completion reports directly to Telegram (via TELEGRAMTOKEN and TELEGRAMCHATID).
• Error Recovery: Retries failed pages automatically with exponential backoff.
• Equipment Parsing: Categorizes and flattens Comfort, Safety, Entertainment, and Extra sections.

---

📤 Getting Your Data

Your results are automatically available in the Apify dataset in multiple formats:

• JSON (default): Full structured vehicle data with nested fields.
• CSV / Excel: Flattened table including key fields, specs, and equipment lists.

---

🧾 Example Extract (JSON)

{
    "listing_id": "53a8e594-eb3a-4871-9252-1e37b6d29816",
    "listing_url": "https://www.autoscout24.com/offers/bmw-114-114i-carplay-siege-chauffant-garantie-gasoline-white-53a8e594-eb3a-4871-9252-1e37b6d29816",
    "status": "Active",
    "created_at": "2025-09-30T12:17:46.407Z",
    "is_deliverable": false,
    "vehicle_type": "ice",
    "description": "BMW 114i -2014 -Essence -Manuel -1.6i 102ch -5 Portes -Clim -CarPlay/AndroidAuto -Bluetooth -Radar de Recul -Sièges Chauffants -Ragulateur de Vitesse -Phares Automatique -Essuie Glace automatique -Vitres teintée  -4 Vitres Électriques -Volant Multifonctions -2 Clés La voiture roule super bien, aucun frais à prévoir. Vendue avec 12 Mois de Garantie, Contrôle Technique et Car-Pass.  Pour plus d'information appelez le 0474 73 49 24.  Visite uniquement sur rendez-vous.",
    "image_count": 15,
    "main_image": "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_758d4e6e-2033-47ee-9d25-7e6c91d1ffc5.jpg/1280x960.webp",
    "all_images": [
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_758d4e6e-2033-47ee-9d25-7e6c91d1ffc5.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_a89bd274-1291-4901-930a-3e108156d789.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_dd89a40a-41d4-4fc6-9ce4-70ffe71b20d9.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_f150ac73-d07c-4d2c-9b9f-b569d88b9cac.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_3bfbdb26-998b-441b-b5eb-28d0a48564e1.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_2155e220-40a9-4753-ba40-95b9ee62c72f.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_c5502789-c54b-47fd-9b3b-c78bab19a38e.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_9887b06f-c161-4d6e-88e6-82eecb961d95.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_ce3d57f7-258a-4c3f-a511-c5bc77bac407.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_3ad277fa-4766-4c47-9f0f-116f276cae67.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_0a759cc0-3e08-4c4e-a78e-c561f97cfa03.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_d053e04d-fa26-4bae-9872-20aa0d8b51d4.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_23d0b080-ba7a-446d-b62b-9a04feab52b1.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_0c700621-5216-4795-a64f-9093cc1f2ab5.jpg/1280x960.webp",
      "https://prod.pictures.autoscout24.net/listing-images/53a8e594-eb3a-4871-9252-1e37b6d29816_e7296074-6cf8-43ef-87e6-03d4a54115f1.jpg/1280x960.webp"
    ],
    "has_360_view": false,
    "price": 9200,
    "price_formatted": "€ 9,200",
    "price_negotiable": false,
    "vat_deductible": false,
    "is_final_price": false,
    "make": "BMW",
    "model": "114",
    "model_version": "114i CarPlay*Siège Chauffant*Garantie",
    "body_type": "Sedan",
    "body_color": "White",
    "paint_type": "Metallic",
    "first_registration": "04/2014",
    "first_registration_raw": "2014-04-01",
    "mileage_km": null,
    "mileage_formatted": "136,130 km",
    "power_kw": 75,
    "power_hp": 102,
    "displacement_ccm": null,
    "cylinders": 4,
    "gears": 6,
    "transmission": "Manual",
    "drive_train": "Rear Wheel Drive",
    "fuel_type": "B",
    "fuel_type_formatted": "Gasoline",
    "fuel_consumption_combined": null,
    "fuel_consumption_formatted": "- (l/100 km)",
    "co2_emission": null,
    "has_particle_filter": false,
    "doors": 5,
    "seats": 5,
    "weight_kg": null,
    "legal_category": [
      "Used"
    ],
    "had_accident": false,
    "full_service_history": true,
    "non_smoking": false,
    "new_inspection": false,
    "previous_owners": null,
    "offer_type": "U",
    "equipment_comfortAndConvenience": [
      "Armrest",
      "Cruise control",
      "Hill Holder",
      "Leather steering wheel",
      "Light sensor",
      "Multi-function steering wheel",
      "Navigation system",
      "Park Distance Control",
      "Parking assist system sensors rear",
      "Rain sensor",
      "Seat heating",
      "Start-stop system",
      "Tinted windows"
    ],
    "equipment_comfortAndConvenience_count": 13,
    "equipment_entertainmentAndMedia": [
      "Android Auto",
      "Apple CarPlay",
      "Bluetooth",
      "Digital cockpit",
      "Digital radio",
      "Hands-free equipment",
      "On-board computer",
      "Radio"
    ],
    "equipment_entertainmentAndMedia_count": 8,
    "equipment_extras": [
      "All season tyres",
      "Alloy wheels",
      "Ambient lighting",
      "Emergency tyre repair kit",
      "Summer tyres",
      "Touch screen",
      "Voice Control",
      "Winter package",
      "Winter tyres"
    ],
    "equipment_extras_count": 9,
    "equipment_safetyAndSecurity": [
      "ABS",
      "Alarm system",
      "Central door lock",
      "Central door lock with remote control",
      "Driver-side airbag",
      "Electronic stability control",
      "Head airbag",
      "Isofix",
      "Passenger-side airbag",
      "Power steering",
      "Rear airbag",
      "Speed limit control system",
      "Tire pressure monitoring system",
      "Traction control"
    ],
    "equipment_safetyAndSecurity_count": 14,
    "total_equipment_count": 44,
    "country": "BE",
    "zip": "1480",
    "city": "Tubize",
    "street": "Rue de l'Atelier 2",
    "latitude": 50.69989,
    "longitude": 4.20648,
    "seller_id": 47287623,
    "seller_type": "Dealer",
    "is_dealer": true,
    "seller_company": "Urban Car",
    "seller_contact_name": "ARBAI Boubkar",
    "seller_phone": "+32 (0)474 - 734924",
    "seller_phone_raw": "+32474734924",
    "dealer_homepage": null,
    "dealer_region": null,
    "warranty_exists": true,
    "leads_range": "Some",
    "ad_tier": "T10",
    "is_mia": false
  }