# Carzone Cars Search Scraper (`stealth_mode/carzone-cars-search-scraper`) Actor Scrape structured car listing data from Carzone.ie search results pages. Collect dealer info, vehicle specs, images, pricing, and 15+ fields per listing — perfect for automotive market research, price monitoring, and inventory analysis. - **URL**: https://apify.com/stealth\_mode/carzone-cars-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, E-commerce, Developer tools - **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 ## Carzone.ie Car Search Scraper: Extract Irish Car Listings at Scale --- ### What Is Carzone.ie? Carzone.ie is one of Ireland's leading used and new car marketplaces, listing thousands of vehicles from dealers and private sellers across the country. Whether you're tracking market prices, building a car comparison tool, or conducting automotive research, manually collecting this data is impractical. The **Carzone.ie Car Search Scraper** automates extraction from search result pages, delivering clean, structured records ready for analysis. --- ### Overview The **Carzone Car Search Scraper** targets Carzone.ie paginated search result pages and extracts comprehensive listing data for each vehicle. It suits: - **Automotive analysts** monitoring used car pricing trends in Ireland - **Dealers** benchmarking competitor inventory and pricing - **Developers** building car comparison or valuation platforms - **Researchers** studying the Irish vehicle market --- ### Input Format ```json { "urls": ["https://www.carzone.ie/search?page=3"], "ignore_url_failures": true, "max_items_per_url": 20 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Carzone.ie search result page URLs (e.g., `/search?page=3`, filtered searches). Add URLs one by one or via bulk edit. | | `max_items_per_url` | `integer` | Maximum listings to collect per URL. Default: `20`. Increase for fuller page coverage. | | `ignore_url_failures` | `boolean` | If `true`, the scraper skips failed URLs and continues instead of stopping the entire run. Default: `true`. | > **Tip:** To scrape multiple pages, add each paginated URL separately (e.g., `?page=1`, `?page=2`). You can also use filtered search URLs (by make, model, county, price range) for targeted extraction. *** ### Output Format **Sample output** ```json { "dealer_detail_summary": { "seller_type": "ContactTrade", "distance_in_miles": null, "dealer_name": "Mercedes-Benz South Dublin", "dealer_id": "3000063", "dealer_logo": "https://c0.carzone.ie/dealer-resource/programme/featured/3000063/3000063mercedes-benz-1-year-warranty.jpg", "town": null, "location": null }, "image_details": [ { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe90d6cfc8f61a9660ba51116838ad9f250.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe994befdb8b66fc7dd254dd1b828528066.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe93765df9cafc9a5951c4f9aae7c5c6895.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe90af8ab7800e8fb73305cf9e4d91f1c15.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9667ae43264bb2346cd0b2e4bc60080ae.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9c129a8791e9c6ed847e3c6f6ec18a57e.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9023c4cfd5269c69c8bcdf8afb9a48df5.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9575c50e1f7087abe643222b0d0180f4e.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9ecb5fe0c57106e5cf3176786c1e4050a.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9ad14f5f0553fac5f806a245c147e98be.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe94e25caf771f63bc8113159e2a11be3f8.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe91055eecf1ba25ee43c66194baef1d20b.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe95f24bddac6029023e910aa5f47dceb73.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe921b6f38ec65cbefa088f2ae45d72d89a.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9c6ad67f7a7eebd15666099710ade325b.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe949d9ee3f887bc0c5b75cb8ee20d345c2.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe95427af5b6a3d25370dcc15ce3e775714.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9493042b709f90fe7aa73cf60b7dc5f82.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9124c7b0da10ab9d8c909a02b4e0aaa2c.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe94fbad6114969a35e176a3e03176c255f.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe903378131b412d51ffb41b885bdd29819.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9371a112ba70ddf4af0e4152e9f7835c3.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9ec7ec10da36f914d3f5886857da9047b.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe99a8c44c1e17f7669d0dd710521cefa3c.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9a12ca36496f9a111dd7fd6da0f0c9f32.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9baab8a69428a660a7e59383b6bd625f7.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9d064f17db751093b090522d7605dd3d7.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe97a1281989e77a2011880173a5f4ea3c1.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9093882f1047dab37cb48d4f86a057c68.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9b1acb7b29d0d4feb1eb343f179e3ed2d.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe93928175126e019d0af4e0cfe0b7f89ef.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9611450d0c7aa639ae12f1c0e8ea19b78.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe987ae845a4025fb7c6e40ef19ebb1a057.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe969a37dcee6ea42dd238979fd4e9078f7.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9e8241523a0e96fb5cbe291a00c28a251.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe95d3d92e3ae96fbe0946991be02484fda.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9e2c99a1f8b478fe752e0dba4fce73dfe.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9a58396a36d35e93be79be0cc86c8a3bd.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9e9b8817461fa7dce0c6404c98afa7431.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9c100951ec0d92088d5ad23c66255e874.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe96b0bbd9445df6bd03d83b819f8d5fe5f.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9736cb796e23d7b2dccec65e96a7a3a86.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe93c0bca9a886e5935ba564560b2e699b7.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9f31a0870caa5ac96715ffc2cc4a8b7e2.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe93edfd8988e64bf8eee5d2d3f6a83ae1a.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe97bec91773d2746260819af1324ffe4a8.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9435556339a5acbbef987c0d90a3301b8.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9df687506fe680fb1fcbdeda28441730f.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe96544538f91b1fb9fbf971311fcccf5ac.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe924436b1c0b73069f6f705a51857a51ad.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9ae1d76c2d76df09d5048f020203024cb.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe98a8c2ae3167f6a23b11839b2aec91e42.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe94726a9450cbc707bc69d779adc0f2844.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9a4e15c0da395c68df0d2660d76cea26a.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe99e515916e8e98e20298e56d1314f780d.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9d8bf545655fb4555a9e2af1f2eb09020.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe998d722639df6fde735a5e69d130cc798.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe9af9aa377d2858104e9b6fa9bc690be0b.jpg" }, { "full_size_image_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe90270e25e2cd4800797f70f5507d6d6ad.jpg", "image_resize_url": "https://c0.carsie.ie/d43864c90df075c94489ddbe4ca5ffe96aed04e724c776ee72f55c6c9e4cbf48.jpg" } ], "public_reference": "4364697", "dealer_reference": null, "search_detail_summary": { "channel": "Car", "year": 2023, "mmv": { "derivative": "GLC220 D 4Matic AMG Line +", "clean_make": "Mercedes-Benz", "clean_model": "GLC Class" }, "fuel_type": "Diesel Hybrid", "transmission": "Automatic", "category": null, "vrm": "231D5135", "mileage": 37050 }, "stock_location": { "city": null, "county": "Dublin" }, "capabilities": [ "HomeDeliveryService", "LiveVideoService", "DealerBranding", "FeaturedDealer", "MobileStandout", "CZTradeIn", "CovidSafetyService", "BrandedSearchStandout", "MobileEnhancedStandout", "Video", "EnhancedSearchStandout", "SearchStandout", "MobileSponsored", "BrandedFeaturedListing", "SimiDealer", "Finance", "EnhancedRetailerStore", "MobileFeaturedListing", "Video360", "FeaturedListing", "CITradeIn", "MobileFeaturedDealer" ], "sale": { "advert_title": "Mercedes-Benz GLC Class GLC220 D 4Matic AMG Line +", "advert_description": "Polar White exterior\n\nBlack Artico interior with black headliner and high-gloss black trim\n\nAMG Line interior and exterior styling package\n\nAMG 19-inch multi-spoke alloy wheels\n\nNight Package with black exterior accents\n\n4MATIC all-wheel drive\n\nSports suspension and sport brake system\n\nPanoramic-style premium ambient lighting with illuminated door sills\n\nSupersport leather multifunction steering wheel with paddle shifters\n\nHeated front seats with electric adjustment and memory function\n\nMBUX Navigation Premium with large central display and digital instrument cluster\n\nApple CarPlay and Android Auto smartphone integration\n\nWireless smartphone charging\n\nParking Package with Active Parking Assist and rear-view camera\n\nBlind Spot Monitoring and Active Lane Keeping Assist\n\nCruise control with speed sign recognition\n\nLED headlights with automatic high beam assist\n\nKEYLESS-Start and electrically folding mirrors\n\nAutomatic powered tailgate and roof rails\n\nDark tinted rear windows and logo projection from mirrors\n\nInterior lighting package with Premium Plus ambient lighting\n\nAt Mercedes-Benz South Dublin, part of the trusted MSL Motor Group since 1959, we pride ourselves on delivering an exceptional luxury car buying experience. As a sister company to Motor Distributors Limited (MDL) - the official distributor of Mercedes-Benz vehicles in Ireland - we share a long-standing legacy of excellence, trust, and expertise in the Mercedes-Benz brand.\n\nThis stunning Mercedes-Benz comes with a comprehensive warranty and is meticulously prepared to meet the highest Mercedes-Benz standards. We accept all makes and models for part exchange and offer a variety of competitive, tailored finance options to suit your needs. Plus, enjoy the convenience of nationwide delivery straight to your door.\n\nFor more information, or to request a personalised video presentation of this sensational model, please contact our dedicated Sales Team on 01-2369200. We look forward to assisting you and helping you discover everything this exceptional vehicle has to offer.\n\n \n\n4 Wheel Drive, ABS, Driver Airbag, Side Airbag, Air Conditioning, 19' Alloys, Armrest, Auto Handbrake, Auto Lights and Wipers, Bluetooth Phone, Centralised locking, Child Locks, Cruise Control, Dual Climate Control, Electrically Adjustable Seats, Electric Mirrors, ESP, Full Service History, Hands Free Kit, Heated Seats, Immobilizer, ISO Fix, Leather Interior, Lumbar Support, Multi-Function Steering Wheel, Onboard Computer, Parking Assistance, Power Steering, Remote Central Locking, Satellite Navigation, Split Fold Rear Seats, Tiptronic, USB, Front Parking Sensors, Rear Parking Sensors, Privacy Glass, Auto Dimming Rear View Mirror, Leather Steering Wheel, Rear View Reversing Camera, Multiple Airbags, Curtain Airbags, Traction Control, 3x3point rear seat belts, Adjustable seats, Adjustable steering column/wheel, Windows front + rear electric, Height adjustable drivers seat, Locking wheel nuts, Outside temperature meter, Rain sensor, Rear armrest, Rear headrests, Rear wiper, Repair history available, Traction control, Media Connection, MP3 Connection, iPod Connection, Rear Curtain Airbags, Remote Boot Release, Car History Checked, Finance Available, Apple Car Play, Android Auto, USB-C, Auto High Beam Assist, Night pack", "advert_pricing": { "price": 63900, "euro_price": 63900, "price_on_application": false, "has_finance_information": true }, "finance": { "percentage_deposit": 20, "mileage": 20000, "weekly_payment": null, "monthly_payment": 1034, "monthly_payment_value": 1033.25, "quote_type": "HP", "duration": 60, "on_road_price": 63900, "customer_deposit": 12780, "total_credit": 51120, "total_amount_payable": 74901.98, "representative_apr": 8.2, "total_interest_payable": 11001.98, "fixed_rate_interest": 7.87, "final_payment": 1096.74, "admin_fee": 63.49, "option_to_purchase_fee": 63.49, "contract_length": 60, "form_url": "https://services.codeweavers.net/forms/quote/9e6c5213-7b39-40d5-9404-f682fdb2518d/apply" }, "cartell_checked": true, "aa_approved": false }, "vehicle": { "registration_year": 2023, "registration_period": 231, "colour": "White", "mileage": { "mileage": 23022, "unit": null, "mileage_km": 37050 }, "owners": 1, "ie_year_half_year": "2023 (231)", "used_approved": true, "registration": "231D5135", "registration_date": "2023-01-13", "mot_date": "2027-01-01", "tax_band": null, "tax_band_code": null, "tax_band_price": null, "manufacturer_colour": "Polar White", "condition": "used", "features": [] }, "has_vehicle_spin": true, "video_link": "https://video.citnow.com/embed/wjvRHJ1MS", "franchise_listing": "mercedes-benz-1-year-warranty", "engine_size": "2.0", "engine_size_cc": null, "volteras": null } ``` Each car listing returns a record with the following fields: #### Dealer & Reference | Field | Meaning | |---|---| | `Dealer Detail Summary` | Dealer name, location, contact info, and profile metadata | | `Dealer Reference` | Dealer's own internal stock/reference number for the vehicle | | `Public Reference` | Carzone's public-facing listing ID for the vehicle | | `Franchise Listing` | Indicates whether the listing belongs to a franchised (manufacturer-authorised) dealer | #### Listing & Search Metadata | Field | Meaning | |---|---| | `Search Detail Summary` | Summary data as returned in search results (price, year, mileage, title) | | `Stock Location` | Geographic location of the vehicle (county/region in Ireland) | | `Capabilities` | Listing feature flags (e.g., finance available, test drive, home delivery) | | `Sale` | Sale or promotion status (e.g., reduced price, special offer) | #### Vehicle Information | Field | Meaning | |---|---| | `Vehicle` | Core vehicle data object — make, model, variant, year, mileage, fuel type, transmission, colour, and body type | | `Engine Size` | Engine displacement in litres (e.g., `2.0L`) | | `Engine Size CC` | Engine displacement in cubic centimetres (e.g., `1998cc`) | | `Volteras` | Electric vehicle-specific data where applicable (e.g., range, battery info) | #### Media | Field | Meaning | |---|---| | `Image Details` | Array of listing image URLs and metadata (thumbnails, full-size, count) | | `Has Vehicle Spin` | Boolean — whether a 360° vehicle spin view is available | | `Video Link` | URL to a video walkthrough of the vehicle, if provided by the dealer | *** ### How to Use 1. **Get search URLs** — Go to Carzone.ie, apply your desired filters (make, county, price, etc.), and copy the results page URL. 2. **Add to input** — Paste URLs into the `urls` array. Add multiple pages or filter variations as separate entries. 3. **Set item limit** — Use `max_items_per_url` to control how many listings per page to collect (max typically ~30 per Carzone search page). 4. **Run the scraper** — Start the actor and monitor progress in the run log. 5. **Export** — Download results as JSON, CSV, or Excel. **Best practices:** - Use specific filter URLs (e.g., `?make=Toyota&county=Dublin`) for targeted datasets. - Set `ignore_url_failures: true` for bulk multi-page runs. - If a page returns no results, verify the URL is a valid Carzone search results page, not a single listing detail page. *** ### Use Cases & Business Value - **Price monitoring:** Track listing prices over time by make, model, or region - **Inventory analysis:** Understand dealer stock composition and turnover - **Market research:** Identify popular vehicle types, fuel trends (EV vs petrol), or regional demand patterns - **Platform development:** Feed structured data into car valuation tools or comparison engines *** ### Conclusion The **Carzone.ie Car Search Scraper** turns paginated Irish car listings into structured, analysis-ready data with minimal setup. With 15+ fields covering vehicle specs, dealer info, media, and listing metadata, it provides everything needed for automotive market intelligence. Configure your search URL, set your limits, and 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://www.carzone.ie/search?page=3" ], "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://www.carzone.ie/search?page=3" ], "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/carzone-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://www.carzone.ie/search?page=3"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/carzone-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://www.carzone.ie/search?page=3" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/carzone-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/carzone-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Carzone Cars Search Scraper", "description": "Scrape structured car listing data from Carzone.ie search results pages. Collect dealer info, vehicle specs, images, pricing, and 15+ fields per listing — perfect for automotive market research, price monitoring, and inventory analysis.", "version": "0.0", "x-build-id": "whvuC7ZOau7bD3hjY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~carzone-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-carzone-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~carzone-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-carzone-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~carzone-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-carzone-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 } } } } } } } } } } ```