# Carvago Cars Search Scraper (`stealth_mode/carvago-cars-search-scraper`) Actor Scrape structured used car data from Carvago.com search results. Collect 80+ fields per listing including price, mileage, VIN, fuel consumption, seller info, and images — perfect for automotive analysts, dealers, and price comparison platforms. - **URL**: https://apify.com/stealth\_mode/carvago-cars-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Carvago.com Cars Search Scraper: Extract Used Car Listings at Scale --- ### What Is Carvago.com? Carvago.com is a pan-European used car marketplace offering thousands of verified vehicle listings across multiple countries. It provides detailed technical specs, pricing transparency, and cross-border purchase options. Manually collecting this data is impractical at scale — the **Carvago.com Cars Search Scraper** automates extraction from search result pages, delivering clean, structured records ready for analysis or integration. --- ### Overview The **Carvago Cars Scraper** collects comprehensive listing data from Carvago search URLs, covering everything from technical specifications to pricing breakdowns and seller details. It is suited for: - **Automotive dealers** monitoring market pricing and inventory trends - **Price comparison platforms** aggregating cross-border car listings - **Market researchers** analyzing used car supply and demand in Europe - **Data engineers** building automotive datasets or valuation models --- ### Input Format ```json { "urls": [ "https://carvago.com/cars/audi?page=2&sort=price&direction=desc" ], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | Search result page URLs from Carvago.com. Supports multiple URLs. Example: filter by make, sort by price, paginate via `?page=N`. | | `max_items_per_url` | `integer` | Maximum listings to collect per URL. Default: `20`. Increase up to your needs (e.g., `50` for broader sweeps). | | `ignore_url_failures` | `boolean` | If `true`, the scraper skips failed URLs and continues the run rather than stopping. Recommended for bulk jobs. | > **Tip:** Build targeted URLs directly on Carvago.com using its filters (make, model, year, price range, country), then copy the resulting URL into the `urls` array. *** ### Output Format ```json { "id": "83408377", "slug": "audi-rsq8-4-0-tfsi-quattro-performance-471-kw", "title": "Audi RSQ8 4.0 TFSI quattro Performance 471 kW", "vin": null, "hot": false, "cubic_capacity": 3996, "power": 471, "number_of_seats": 5, "fuel_consumption_urban": null, "fuel_consumption_extra_urban": null, "fuel_consumption_combined": 13.1, "fuel_consumption_unit": "LITER", "power_unit": "kW", "weight": 2250, "number_of_gears": 8, "carbon_dioxide_emission": 297, "equipment_score": null, "manufactured_from": { "date": "2024-06-01 00:00:00.000000", "timezone_type": 1, "timezone": "+02:00" }, "manufactured_to": null, "number_of_airbags": null, "number_of_cylinders": null, "created_at": { "date": "2026-04-29 05:36:43.000000", "timezone_type": 1, "timezone": "+02:00" }, "updated_at": "2026-05-14T14:06:18+02:00", "active_at": "2026-04-29T09:10:39+02:00", "registration_date": "2025-09-01", "mileage": 2989, "number_of_owners": null, "origin_country": null, "last_registration_country": null, "technical_inspection_valid_to": null, "export_advantage": null, "number_of_keys": null, "warranty_mileage": null, "warranty_date": null, "source_created_at": "2026-04-24", "manufacture_date": "2025-09-01", "first_registration_country": null, "former_country": null, "wheel_diameter": null, "registered": null, "only_for_export": null, "score": 0, "source_name": "autoscout24", "external_url": "https://www.autoscout24.de/angebote/audi-rs-q8-rsq8-4-0-tfsi-quattro-performance-urban-full-p-benzin-grau-5641319e-0572-4dd7-8055-0421356e8112", "advertisement_score": null, "first_crawl": { "date": "2026-04-24 11:02:42.000000", "timezone_type": 1, "timezone": "+02:00" }, "location_post_code": "3316GN", "location_street": "Madame Curiestraat", "location_city": "DORDRECHT", "location_number": "24a", "location_country": { "id": "33", "const_key": "COUNTRY_NETHERLANDS", "name": "Netherlands", "iso_code": "NL" }, "status": "active", "external_score": null, "suggested": false, "seller": { "id": "47953763", "type": { "id": "4", "const_key": "SELLERTYPE_PARTNER_DEALERSHIP", "name": "Dealership" }, "country": { "id": "33", "const_key": "COUNTRY_NETHERLANDS", "name": "Netherlands", "iso_code": "NL" }, "zip": "3316", "email": null, "rating_average": null, "rating_count": null, "offers_count": 279 }, "hidden": false, "in_preparation": false, "sold_at": null, "delisted_at": null, "external_id": "autoscout24-5641319e-0572-4dd7-8055-0421356e8112", "uniform_price": 214835, "number_of_images": 50, "platform": null, "advertising_rules": [ { "uuid": "6f6be05e-8942-4cfb-885a-53b895fdd163" } ], "available_in_feed": null, "available_in_feed_computed": true, "make": { "const_key": "MAKE_AUDI", "label": "Audi" }, "model": { "const_key": "MAKE_AUDI-MODELFAMILY_RSQ8", "label": "RSQ8" }, "catalog_features": [ { "const_key": "CARSTYLE_SUV_OFFROAD", "label": "SUV / Off-road", "seo_label": "suv-offroad", "category": null, "category_label": null, "parent": null }, { "const_key": "COLOR_GREY", "label": "Grey", "seo_label": "grey", "category": null, "category_label": null, "parent": null }, { "const_key": "CONDITION_USED", "label": "Used", "seo_label": "condition-used", "category": null, "category_label": null, "parent": null }, { "const_key": "CURRENCY_EUR", "label": "Euro", "seo_label": null, "category": null, "category_label": null, "parent": null }, { "const_key": "DOORCOUNT_4_5", "label": "4/5", "seo_label": "doorcount-4-5", "category": null, "category_label": null, "parent": null }, { "const_key": "DRIVE_4X4", "label": "4x4", "seo_label": "drive-4x4", "category": null, "category_label": null, "parent": null }, { "const_key": "EMISSIONCLASS_6D_TEMP", "label": "Euro 6d-TEMP", "seo_label": "euro-6d-temp", "category": null, "category_label": null, "parent": null }, { "const_key": "FEATURE_ABS", "label": "ABS", "seo_label": "abs", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_AC_4ZONE", "label": "Automatic 4-zones air conditioning", "seo_label": "air-conditioning-4-zone", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": "FEATURE_AC_MULTIZONE" }, { "const_key": "FEATURE_AIR_SUSPENSION", "label": "Air suspension", "seo_label": "air-suspension", "category": "FEATURE_CATEGORY_TRANSMISSION_AND_SUSPENSION", "category_label": "Transmission and Suspension", "parent": null }, { "const_key": "FEATURE_ALARM", "label": "Alarm", "seo_label": "alarm", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_AMBIENT_LIGHTING", "label": "Ambient lighting", "seo_label": "ambient-lighting", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_ARMREST", "label": "Armrest front", "seo_label": "armrest-front", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_AUDIO_EXTRA", "label": "Extra audio", "seo_label": "audio-optional", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_BLUETOOTH", "label": "Bluetooth", "seo_label": "bluetooth", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_CORNERING_LIGHTS", "label": "Cornering lights", "seo_label": "cornering-lights", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_CRUISECONTROL_ADAPTIVE", "label": "Adaptive cruise control", "seo_label": "cruise-control-adaptive", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": "FEATURE_CRUISECONTROL" }, { "const_key": "FEATURE_DAB_RADIO", "label": "DAB radio", "seo_label": "dab-radio", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_DAYTIME_RUNNING_LIGHTS", "label": "Daytime running lights", "seo_label": "daytime-running-lights", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_DIGITAL_COCKPIT", "label": "Digital cockpit", "seo_label": "digital-cluster", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_ELECTRIC_TAILGATE", "label": "Electric tailgate", "seo_label": "power-tailgate", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_ELECTRIC_WINDOWS_FRONT_ELECTRIC_WINDOWS", "label": "Front electric windows", "seo_label": "power-windows-front", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_EMERGENCY_CALL", "label": "Emergency call", "seo_label": "emergency-call", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_ESP", "label": "ESP", "seo_label": "esp", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_FRONT_COLLISION_WARNING_SYSTEM", "label": "Front collision warning system", "seo_label": "front-collision-warning", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_FRONT_SEATS_ELECTRIC_ADJUSTABLE", "label": "Electric adjustable front seats", "seo_label": "power-front-seats", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_FRONT_SEATS_HEATED", "label": "Heated front seats", "seo_label": "heated-front-seats", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_FRONT_SEATS_SPORT_SEATS", "label": "Sport front seats", "seo_label": "sport-seats", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_FRONT_SEATS_VENTILATED", "label": "Ventilated front seats", "seo_label": "ventilated-front-seats", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_FRONT_SEATS_WITH_MASSAGE_FUNCTION_DRIVER", "label": "Driver's seat with massage", "seo_label": "massage-driver-seat", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_GLARE_FREE_HIGH_BEAM_HEADLIGHTS", "label": "Glare-free high beam headlights", "seo_label": "glarefree-headlights", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_HANDSFREE", "label": "Handsfree", "seo_label": "handsfree", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_HEADLIGHTSTYPE_LASER", "label": "Laser headlights", "seo_label": "laser", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": "FEATURE_HEADLIGHTSTYPE_EXTRA" }, { "const_key": "FEATURE_HEAD_UP_DISPLAY", "label": "Head-up display", "seo_label": "head-up-display", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_HEATED_STEERING_WHEEL", "label": "Heated steering wheel", "seo_label": "heated-steering-wheel", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_HIGH_BEAM_ASSIST", "label": "High beam assist", "seo_label": "high-beam-assist", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_HILL_START_ASSIST", "label": "Hill-start assist", "seo_label": "hill-start-assist", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_INDUCTION_CHARGING_FOR_SMARTPHONES", "label": "Induction charging for smartphones", "seo_label": "wireless-phone-charging", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_KEYLESS_ENTRY", "label": "Keyless entry", "seo_label": "keyless-entry", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_KEYLESS_IGNITION", "label": "Keyless ignition", "seo_label": "keyless-start", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_LEATHER_STEERING_WHEEL", "label": "Leather steering wheel", "seo_label": "leather-steering-wheel", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_LIGHT_SENSOR", "label": "Light sensor", "seo_label": "light-sensor", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_LINE_ASSIST", "label": "Lane assist", "seo_label": "lane-assist", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_MULTIFUNCTIONAL_STEERING_WHEEL", "label": "Multifunctional steering wheel", "seo_label": "multifunction-steering-wheel", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_NAVIGATION_SYSTEM", "label": "Navigation system", "seo_label": "satnav", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_NIGHT_VISSION_ASSIST", "label": "Night vision assist", "seo_label": "night-vision", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_PADDLE_SHIFTERS", "label": "Paddle shifters", "seo_label": "paddle-shift", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_PANORAMIC_ROOF", "label": "Panoramic roof", "seo_label": "panoramic-sunroof", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_PARKINGCAMERA", "label": "Parking camera", "seo_label": "parking-camera", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_PARKINGSENSORS_FRONT_REAR", "label": "Front and rear parking sensors", "seo_label": "parking-sensors-front-rear", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": "FEATURE_PARKINGSENSORS" }, { "const_key": "FEATURE_POWER_ASSISTED_STEERING", "label": "Power assisted steering", "seo_label": "power-steering", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_RADIO", "label": "Radio", "seo_label": "radio", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_RAIN_SENSOR", "label": "Rain sensor", "seo_label": "auto-wipers", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_REAR_SEATS_HEATED_REAR_SEATS", "label": "Heated rear seats", "seo_label": "heated-rear-seats", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_ROOF_RAILS", "label": "Roof Rails", "seo_label": "roof-rails", "category": "FEATURE_CATEGORY_ACCESSORIES_AND_EXTRA_FEATURES", "category_label": "Accessories and Extra features", "parent": null }, { "const_key": "FEATURE_SIDE_MIRRORS_WITH_ELECTRIC_ADJUSTMENT", "label": "Side mirrors with electric adjustment", "seo_label": "power-mirrors", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_SPORT_SUSPENSION_SYSTEM", "label": "Sport-suspension system", "seo_label": "sport-suspension", "category": "FEATURE_CATEGORY_TRANSMISSION_AND_SUSPENSION", "category_label": "Transmission and Suspension", "parent": null }, { "const_key": "FEATURE_START_STOP_SYSTEM", "label": "Start-stop system", "seo_label": "start-stop", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_SUNROOF", "label": "Sunroof", "seo_label": "sunroof", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_TINTED_WINDOWS", "label": "Tinted windows", "seo_label": "tinted-windows", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FEATURE_TRAFFIC_SIGN_RECOGNITION", "label": "Traffic sign recognition", "seo_label": "traffic-sign-recognition", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_TYRE_PRESSURE_MONITORING", "label": "Tyre pressure monitoring", "seo_label": "tyre-pressure-monitoring", "category": "FEATURE_CATEGORY_SECURITY_SAFETY_ASSISTANCE", "category_label": "Security, Safety and Assistance", "parent": null }, { "const_key": "FEATURE_WLAN_WIFI_HOTSPOT", "label": "WLAN/Wifi hotspot", "seo_label": "wifi", "category": "FEATURE_CATEGORY_COMFORT_CONVENIENCE", "category_label": "Comfort and Convenience", "parent": null }, { "const_key": "FUELTYPE_PETROL", "label": "Petrol", "seo_label": "petrol", "category": null, "category_label": null, "parent": null }, { "const_key": "INTERIORCOLOR_BLACK", "label": "Black", "seo_label": "interior-black", "category": null, "category_label": null, "parent": null }, { "const_key": "INTERIORMATERIAL_FULL_LEATHER", "label": "Full leather", "seo_label": "full-leather", "category": null, "category_label": null, "parent": null }, { "const_key": "TRANSMISSION_AUTOMATIC", "label": "Automatic", "seo_label": "transmission-auto", "category": null, "category_label": null, "parent": null }, { "const_key": "VEHICLETYPE_PASSENGER_CAR", "label": "Car", "seo_label": "cars", "category": null, "category_label": null, "parent": null } ], "vehicle_class": "CLASS_ESUV", "vehicle_tags": [ { "const_key": "TAG_FAMILY_ALL" }, { "const_key": "TAG_FAMILY_LARGE" }, { "const_key": "TAG_PERFORMANCE" }, { "const_key": "TAG_PREMIUM" }, { "const_key": "TAG_SUV_ALL" } ], "labels": [], "emission": { "co2": 297, "co2_class": "G", "co2_cost_annual_high": 8464.5, "co2_cost_annual_low": 2450.25, "co2_cost_annual_medium": 5123.25, "co2_energy_cost_annual": 3360, "fuel_consumption": 13.1, "vehicle_tax_de": 484, "consumption_hybrid_kwh_100_km": null }, "is_for_premium_slot": false, "image": { "id": -1808705519, "path": "https://storage.alpha-analytics.cz/get/a730b3ef-05a4-4de2-8763-7472e0f8ca3f?ts=1777451788" }, "images": [ { "id": -1808705519, "path": "https://storage.alpha-analytics.cz/get/a730b3ef-05a4-4de2-8763-7472e0f8ca3f?ts=1777451788", "ordering": 0, "ordering_computed": 10119 }, { "id": -1808705514, "path": "https://storage.alpha-analytics.cz/get/d1ab2b0e-1914-4c92-a284-615b4d7b861c?ts=1777446639", "ordering": 5, "ordering_computed": 10119 }, { "id": -1808705515, "path": "https://storage.alpha-analytics.cz/get/976145b2-3a44-411a-9d08-58a2338ba7d7?ts=1777446672", "ordering": 4, "ordering_computed": 12407 }, { "id": -1808705516, "path": "https://storage.alpha-analytics.cz/get/1b33c278-a930-4e54-a7fc-d270e69d4bf6?ts=1777446612", "ordering": 3, "ordering_computed": 30114 }, { "id": -1808705512, "path": "https://storage.alpha-analytics.cz/get/92bae03a-ddb2-4d57-887d-c02b7a9435c0?ts=1777446674", "ordering": 7, "ordering_computed": 92451 }, { "id": -1808705517, "path": "https://storage.alpha-analytics.cz/get/c60db583-7d3d-4526-b82c-7bb1e04d54ac?ts=1777446641", "ordering": 2, "ordering_computed": 100133 }, { "id": -1808705518, "path": "https://storage.alpha-analytics.cz/get/c58e8b51-66a0-4f4f-853e-8e434c66d178?ts=1777446656", "ordering": 1, "ordering_computed": 120143 }, { "id": -1808705513, "path": "https://storage.alpha-analytics.cz/get/54b391e9-f232-410c-9c24-c7efaaefaab0?ts=1777446657", "ordering": 6, "ordering_computed": 130231 }, { "id": -1808705511, "path": "https://storage.alpha-analytics.cz/get/86912028-0a4e-43b1-8b14-7072db0a4ecb?ts=1777446287", "ordering": 8, "ordering_computed": null }, { "id": -1808705510, "path": "https://storage.alpha-analytics.cz/get/5b4f4762-76c4-414b-9dfd-304df4e5c6b9?ts=1777445963", "ordering": 9, "ordering_computed": null }, { "id": -1808705509, "path": "https://storage.alpha-analytics.cz/get/8f50e778-aa9b-4417-ad38-9f75f717caaf?ts=1777446309", "ordering": 10, "ordering_computed": null }, { "id": -1808705508, "path": "https://storage.alpha-analytics.cz/get/50bb45e7-7be1-492c-8a81-0516ce6a753a?ts=1777446055", "ordering": 11, "ordering_computed": null }, { "id": -1808705507, "path": "https://storage.alpha-analytics.cz/get/6e741a64-d43e-4bc2-aa68-795567985225?ts=1777446453", "ordering": 12, "ordering_computed": null }, { "id": -1808705506, "path": "https://storage.alpha-analytics.cz/get/a636ea40-64b2-4ddd-865e-27ee6dfc4846?ts=1777446052", "ordering": 13, "ordering_computed": null }, { "id": -1808705505, "path": "https://storage.alpha-analytics.cz/get/939cedce-3fe3-4893-8581-12f7781bdbc6?ts=1777446286", "ordering": 14, "ordering_computed": null }, { "id": -1808705504, "path": "https://storage.alpha-analytics.cz/get/4755f37a-61ac-4dae-ac22-416e644d6a9f?ts=1777446055", "ordering": 15, "ordering_computed": null }, { "id": -1808705503, "path": "https://storage.alpha-analytics.cz/get/04934982-056d-497e-bd3f-fda938bf8c0e?ts=1777446420", "ordering": 16, "ordering_computed": null }, { "id": -1808705502, "path": "https://storage.alpha-analytics.cz/get/9396ee8a-8c12-4194-9c37-daabaa68ee2c?ts=1777446328", "ordering": 17, "ordering_computed": null }, { "id": -1808705501, "path": "https://storage.alpha-analytics.cz/get/c256e52f-9131-4e82-860b-add836cb3d75?ts=1777446318", "ordering": 18, "ordering_computed": null }, { "id": -1808705500, "path": "https://storage.alpha-analytics.cz/get/54f06990-767a-415d-93b6-17cea711dca1?ts=1777446025", "ordering": 19, "ordering_computed": null }, { "id": -1808705499, "path": "https://storage.alpha-analytics.cz/get/ef20cd93-a1c8-4966-a058-f135c055a7e1?ts=1777446053", "ordering": 20, "ordering_computed": null }, { "id": -1808705498, "path": "https://storage.alpha-analytics.cz/get/df9ea0fb-ad19-4ad3-bc6c-13b74a1194a5?ts=1777446326", "ordering": 21, "ordering_computed": null }, { "id": -1808705497, "path": "https://storage.alpha-analytics.cz/get/8724ff62-259c-4fd7-a9f5-4cae7710fe1c?ts=1777446466", "ordering": 22, "ordering_computed": null }, { "id": -1808705496, "path": "https://storage.alpha-analytics.cz/get/4f8c09c0-5f59-4361-87a8-a8340eb1b728?ts=1777446469", "ordering": 23, "ordering_computed": null }, { "id": -1808705495, "path": "https://storage.alpha-analytics.cz/get/0a1fa6dc-4095-4855-bdb0-0646f85f55f4?ts=1777446313", "ordering": 24, "ordering_computed": null }, { "id": -1808705494, "path": "https://storage.alpha-analytics.cz/get/67c16e7a-b4db-4269-a2c1-e455e5699636?ts=1777446416", "ordering": 25, "ordering_computed": null }, { "id": -1808705493, "path": "https://storage.alpha-analytics.cz/get/fcd7345b-f35a-48e9-9086-a900f985d5f8?ts=1777446287", "ordering": 26, "ordering_computed": null }, { "id": -1808705492, "path": "https://storage.alpha-analytics.cz/get/fdb7a1ac-cb36-40ac-8e01-91183ae003d3?ts=1777446215", "ordering": 27, "ordering_computed": null }, { "id": -1808705491, "path": "https://storage.alpha-analytics.cz/get/dee7a139-0a88-4cd8-a6cd-f5c9fef6709d?ts=1777445962", "ordering": 28, "ordering_computed": null }, { "id": -1808705490, "path": "https://storage.alpha-analytics.cz/get/3941d84a-24bc-40f4-9e1a-4cf15e1e0712?ts=1777446294", "ordering": 29, "ordering_computed": null }, { "id": -1808705489, "path": "https://storage.alpha-analytics.cz/get/0b1e0bca-ad01-4e3b-9093-ee87b5299f25?ts=1777446470", "ordering": 30, "ordering_computed": null }, { "id": -1808705488, "path": "https://storage.alpha-analytics.cz/get/dd114183-18a8-4ccc-9e86-30966a3276a7?ts=1777446047", "ordering": 31, "ordering_computed": null }, { "id": -1808705487, "path": "https://storage.alpha-analytics.cz/get/0f3982e9-fd6f-4da6-9860-b4648ba36763?ts=1777445967", "ordering": 32, "ordering_computed": null }, { "id": -1808705486, "path": "https://storage.alpha-analytics.cz/get/931ecabf-dea4-4b77-9b98-95b2dbad3bae?ts=1777446295", "ordering": 33, "ordering_computed": null }, { "id": -1808705485, "path": "https://storage.alpha-analytics.cz/get/9afddb28-e896-49cd-8369-919a7e66b2b4?ts=1777446311", "ordering": 34, "ordering_computed": null }, { "id": -1808705484, "path": "https://storage.alpha-analytics.cz/get/be93403e-bde0-491d-94a2-0fe195e7422e?ts=1777446214", "ordering": 35, "ordering_computed": null }, { "id": -1808705483, "path": "https://storage.alpha-analytics.cz/get/622e9e45-a3f5-4d8c-bf16-fdb5cdcbcfd9?ts=1777446290", "ordering": 36, "ordering_computed": null }, { "id": -1808705482, "path": "https://storage.alpha-analytics.cz/get/78ebc925-6c2c-41ca-ac09-0afb6ee29ef6?ts=1777446456", "ordering": 37, "ordering_computed": null }, { "id": -1808705481, "path": "https://storage.alpha-analytics.cz/get/d874e068-969e-49c0-bcc0-72340482e36f?ts=1777446296", "ordering": 38, "ordering_computed": null }, { "id": -1808705480, "path": "https://storage.alpha-analytics.cz/get/45c9fa06-1c2a-4231-b5ff-ff81b6f0c260?ts=1777446259", "ordering": 39, "ordering_computed": null }, { "id": -1808705479, "path": "https://storage.alpha-analytics.cz/get/a382b30d-ed07-4ad5-8c0a-c864949b299f?ts=1777446183", "ordering": 40, "ordering_computed": null }, { "id": -1808705478, "path": "https://storage.alpha-analytics.cz/get/fc1be966-4a5b-4cdb-a069-7c3665e4d0cf?ts=1777446234", "ordering": 41, "ordering_computed": null }, { "id": -1808705027, "path": "https://storage.alpha-analytics.cz/get/405a92be-4ac4-421e-9477-db61e5fece41?ts=1777446283", "ordering": 42, "ordering_computed": null }, { "id": -1808705026, "path": "https://storage.alpha-analytics.cz/get/10edc1b5-43de-4cec-84f2-d89d010e9242?ts=1777446434", "ordering": 43, "ordering_computed": null }, { "id": -1808705025, "path": "https://storage.alpha-analytics.cz/get/83e865a6-0d82-432f-9ef8-77a42dc0dd90?ts=1777446275", "ordering": 44, "ordering_computed": null }, { "id": -1808705024, "path": "https://storage.alpha-analytics.cz/get/f19d0abf-4bd9-493f-91bd-7b1e10b919f0?ts=1777446403", "ordering": 45, "ordering_computed": null }, { "id": -1808705023, "path": "https://storage.alpha-analytics.cz/get/97915ae6-74fe-4a2d-be9b-b69cace6dd43?ts=1777445980", "ordering": 46, "ordering_computed": null }, { "id": -1808705022, "path": "https://storage.alpha-analytics.cz/get/da979694-84eb-4753-a4d4-e430cca32a95?ts=1777446367", "ordering": 47, "ordering_computed": null }, { "id": -1808705021, "path": "https://storage.alpha-analytics.cz/get/da64cc92-9dbc-4e04-be1b-d2175c779248?ts=1777446363", "ordering": 48, "ordering_computed": null }, { "id": -1808705020, "path": "https://storage.alpha-analytics.cz/get/81b3fcb1-0689-4b14-8790-7b0dd7f1d8eb?ts=1777446297", "ordering": 49, "ordering_computed": null } ], "main_image": "https://storage.alpha-analytics.cz/get/a730b3ef-05a4-4de2-8763-7472e0f8ca3f?ts=1777451788", "price_information": { "currency": { "id": 9, "name": "EUR", "const_key": "CURRENCY_EUR" }, "vat_reclaimable": true, "margin_data": { "price_with_margin": 223807.4, "margin_price": 8972.399999999994, "margin_percent": 4.18, "price_margin_fixed": false }, "nice_price_data": { "price": 270849, "price_without_vat": 223842 }, "price_data": { "price": 270807, "vat_rate": 21, "price_without_vat": 223807 }, "previous_price_data": null, "discount_data": { "price": 0, "vat_rate": 21, "price_without_vat": 0, "is_discounted": false, "discount_date": null, "last_price_change": null } }, "price_score": { "similar_cars_count": 234, "uniform_price_percentiles": [ 292830, 177197, 167454, 161904, 154771, 119146 ], "uniform_price_percentile_level": 5, "pp_level": 1 }, "price": 270849, "price_without_vat": 223842, "total_price": 0, "vat_rate": 21, "exact_price": 270849, "exact_price_without_vat": 223842, "vat_reclaimable": true, "price_currency": { "id": 9, "name": "EUR", "const_key": "CURRENCY_EUR" }, "original_currency": { "id": "9" }, "power_hp": 640 } ``` Each listing returns a record with 80+ fields grouped below by category. #### Identification | Field | Meaning | |---|---| | `ID` | Carvago's internal listing ID | | `Slug` | URL-friendly identifier for the listing | | `Title` | Full listing title (e.g., "Audi A6 2.0 TDI S tronic") | | `VIN` | Vehicle Identification Number (17-character unique code) | | `External ID` | ID assigned by the original source platform | | `Source Name` | Name of the source platform or dealer system | | `External URL` | Link to the listing on the original source site | | `Platform` | Platform identifier where the car was originally listed | #### Technical Specifications | Field | Meaning | |---|---| | `Cubic Capacity` | Engine displacement in cc | | `Power` | Engine power in the unit defined by `Power Unit` | | `Power HP` | Engine power converted to horsepower | | `Power Unit` | Unit of power measurement (e.g., kW, HP) | | `Number Of Seats` | Total seating capacity | | `Number Of Gears` | Gearbox gear count | | `Number Of Cylinders` | Engine cylinder count | | `Number Of Airbags` | Total airbags in the vehicle | | `Weight` | Vehicle weight (typically in kg) | | `Wheel Diameter` | Wheel/rim diameter | | `Vehicle Class` | Body style category (e.g., sedan, SUV, hatchback) | #### Fuel & Emissions | Field | Meaning | |---|---| | `Fuel Consumption Urban` | Consumption in city driving | | `Fuel Consumption Extra Urban` | Consumption on open roads | | `Fuel Consumption Combined` | Combined average consumption | | `Fuel Consumption Unit` | Unit for consumption values (e.g., L/100km) | | `Carbon Dioxide Emission` | CO₂ output in g/km | | `Emission` | Emission standard classification (e.g., Euro 6) | #### Dates & History | Field | Meaning | |---|---| | `Manufacture Date` | Month/year the vehicle was manufactured | | `Manufactured From` | Start of the production range for this model variant | | `Manufactured To` | End of the production range for this model variant | | `Registration Date` | Date of first registration | | `First Registration Country` | Country where the car was first registered | | `Last Registration Country` | Most recent country of registration | | `Origin Country` | Country of vehicle origin | | `Former Country` | Previous country before current listing | | `Technical Inspection Valid To` | Expiry date of the vehicle's technical inspection (MOT/TÜV equivalent) | | `Created At` | Timestamp when the record was created in Carvago's system | | `Updated At` | Last modification timestamp | | `Active At` | When the listing became active | | `Source Created At` | Creation timestamp from the original source | | `First Crawl` | Timestamp of when Carvago first indexed this listing | | `Sold At` | Timestamp when the vehicle was marked as sold | | `Delisted At` | Timestamp when the listing was removed | #### Condition & Ownership | Field | Meaning | |---|---| | `Mileage` | Odometer reading | | `Number Of Owners` | Total number of previous owners | | `Number Of Keys` | Number of keys included with the vehicle | | `Registered` | Whether the vehicle is currently registered | #### Pricing | Field | Meaning | |---|---| | `Price` | Listed price (in `Price Currency`) | | `Price Without VAT` | Price excluding VAT | | `Total Price` | Final total price including all fees | | `Exact Price` | Precise price figure | | `Exact Price Without VAT` | Precise price excluding VAT | | `VAT Rate` | Applicable VAT percentage | | `VAT Reclaimable` | Whether VAT can be reclaimed (relevant for business buyers) | | `Price Currency` | Currency of the listed price | | `Original Currency` | Currency from the source listing | | `Uniform Price` | Normalized price for cross-market comparison | | `Price Score` | Carvago's assessment of price competitiveness | | `Price Information` | Structured pricing metadata object | #### Scores & Ratings | Field | Meaning | |---|---| | `Score` | Overall listing quality score | | `Equipment Score` | Score based on included equipment/features | | `Advertisement Score` | Quality score of the listing advertisement | | `External Score` | Score from the originating platform | #### Listing Flags & Status | Field | Meaning | |---|---| | `Status` | Current listing status (active, sold, delisted, etc.) | | `Hot` | Whether Carvago has flagged the listing as a hot deal | | `Suggested` | Whether Carvago recommends this listing | | `Hidden` | Whether the listing is hidden from public results | | `In Preparation` | Whether the listing is being prepared (not yet fully active) | | `Only For Export` | Whether the vehicle is available for export only | | `Export Advantage` | Indicates a pricing advantage for export buyers | | `Available In Feed` | Whether the listing appears in data feeds | | `Available In Feed Computed` | Computed feed availability status | | `Is For Premium Slot` | Whether the listing occupies a premium advertising slot | | `Advertising Rules` | Rules governing how this listing may be advertised | #### Warranty | Field | Meaning | |---|---| | `Warranty Mileage` | Remaining warranty mileage coverage | | `Warranty Date` | Warranty expiry date | #### Location & Seller | Field | Meaning | |---|---| | `Location City` | City where the vehicle is located | | `Location Street` | Street address of the listing | | `Location Number` | Street number | | `Location Post Code` | Postal code | | `Location Country` | Country of the listing | | `Seller` | Seller profile object (dealer or private) | #### Classification & Features | Field | Meaning | |---|---| | `Make` | Vehicle manufacturer (e.g., Audi, BMW) | | `Model` | Vehicle model name | | `Catalog Features` | List of standard and optional features | | `Vehicle Tags` | Internal classification tags | | `Labels` | Display labels applied to the listing | #### Images | Field | Meaning | |---|---| | `Image` | Primary image URL | | `Main Image` | Main display image object | | `Images` | Full array of all listing image URLs | | `Number Of Images` | Total image count | *** ### How to Use 1. **Build your search URL** — Use Carvago.com's filters (make, model, year, fuel type, price range) and copy the resulting URL from your browser. 2. **Configure input** — Add URLs to the `urls` array. Set `max_items_per_url` based on how many listings you need per page. 3. **Run the scraper** — Start the actor and monitor progress in the run log. 4. **Export results** — Download as JSON, CSV, or Excel for analysis or integration. **Best practices:** - Use paginated URLs (`?page=1`, `?page=2`) to cover full result sets. - Set `ignore_url_failures: true` for multi-URL runs to avoid interruptions. - Combine multiple filtered URLs in one run (e.g., different makes or regions). *** ### Use Cases & Business Value - **Price benchmarking:** Compare market prices across makes, models, and countries - **Inventory monitoring:** Track listing volumes and availability trends over time - **Valuation models:** Build datasets for ML-based car pricing tools - **Export sourcing:** Identify export-advantaged vehicles using the `Export Advantage` flag *** ### Conclusion The **Carvago.com Cars Search Scraper** delivers one of the most comprehensive per-listing datasets available from any European used car platform — 80+ fields covering specs, pricing, history, location, and seller data. Whether you're building a pricing tool or conducting market research, it eliminates manual effort and scales to thousands of listings per run. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://carvago.com/cars/audi?page=2&sort=price&direction=desc" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://carvago.com/cars/audi?page=2&sort=price&direction=desc" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/carvago-cars-search-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 = { "urls": ["https://carvago.com/cars/audi?page=2&sort=price&direction=desc"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/carvago-cars-search-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 '{ "urls": [ "https://carvago.com/cars/audi?page=2&sort=price&direction=desc" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/carvago-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/carvago-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Carvago Cars Search Scraper", "description": "Scrape structured used car data from Carvago.com search results. Collect 80+ fields per listing including price, mileage, VIN, fuel consumption, seller info, and images — perfect for automotive analysts, dealers, and price comparison platforms.", "version": "0.0", "x-build-id": "YjESEHlNO61IhNIfi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~carvago-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-carvago-cars-search-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/stealth_mode~carvago-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-carvago-cars-search-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/stealth_mode~carvago-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-carvago-cars-search-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": { "urls": { "title": "URLs of the Cars list urls to scrape", "type": "array", "description": "Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```