# ContactCars Cars Details Scraper (`ecomscrape/contactcars-cars-details-scraper`) Actor

ContactCars.com Car Details Scraper automates extraction of detailed vehicle information including pricing, specifications, dealer contacts, warranty data, and financing options from Egypt's premier automotive marketplace for automotive dealers, market researchers, and car buyers.

- **URL**: https://apify.com/ecomscrape/contactcars-cars-details-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Automation, Developer tools, Lead generation
- **Stats:** 3 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

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

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

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

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

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

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## ContactCars.com Car Details Scraper: Extract Comprehensive Vehicle Data from Egypt's Leading Auto Marketplace

### Introduction

ContactCars.com serves as Egypt's leading online automotive marketplace, connecting car buyers with dealers and private sellers across the country. The platform hosts thousands of vehicle listings with comprehensive details including technical specifications, pricing information, dealer contacts, financing options, warranty data, and inspection availability.

For automotive dealers conducting competitive analysis, market researchers tracking pricing trends, car buyers comparing multiple vehicles, or businesses building automotive databases, accessing this detailed vehicle information is essential. However, manually collecting data from individual car listings is extremely time-consuming, especially when analyzing market trends or building comprehensive vehicle databases.

The ContactCars.com Car Details Scraper automates this process by systematically extracting complete vehicle information from individual car detail pages. Whether you're analyzing market prices for specific models, tracking dealer inventory, researching financing options, or building automotive intelligence databases, this scraper enables efficient data collection from Egypt's automotive market.

### Scraper Overview

The ContactCars.com Car Details Scraper is a specialized extraction tool designed to collect comprehensive vehicle information from individual car listing pages. The scraper captures over 90 distinct data fields covering everything from basic vehicle specifications to advanced dealer information, financing details, warranty coverage, and inspection availability.

Key advantages include residential proxy support for reliable access, configurable retry mechanisms for network resilience, and complete data extraction covering all available fields. It's particularly valuable for automotive dealers monitoring competition, market analysts tracking Egyptian automotive trends, car buyers researching multiple vehicles, and businesses building automotive pricing databases.

The tool handles various vehicle types across different makes, models, and price ranges, maintaining data accuracy while respecting platform guidelines. Users can process multiple vehicle URLs to build comprehensive datasets for analysis, comparison, or business intelligence purposes.

### Input and Output Details

Example url 1: https://www.contactcars.com/en/used-cars/porsche-cayenne/f0b477311edb

Example url 2: https://www.contactcars.com/en/new-cars/cadillac-vistiq/for-sale/c66c963be6c0

Example url 3: https://www.contactcars.com/en/new-cars/byd-leopard_8/for-sale/9ee85f18c990

Example Screenshot of cars information page:

![](https://i.ibb.co/Y73Tx5vC/Screenshot-from-2026-01-13-16-55-30.png)

#### Input Format

The scraper accepts URLs of specific car detail pages from ContactCars.com:

```json
{
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "EG"
  },
  "urls": [
    "https://www.contactcars.com/en/used-cars/porsche-cayenne/f0b477311edb",
    "https://www.contactcars.com/en/new-cars/byd-leopard_8/for-sale/9ee85f18c99",
    "https://www.contactcars.com/en/new-cars/cadillac-vistiq/for-sale/c66c963be6c0"
  ],
  "max_retries_per_url": 2
}
```

**The `urls` parameter**: Add URLs of specific car detail pages you want to scrape. Navigate to ContactCars.com, find vehicles of interest, then copy their detail page URLs. Use Bulk edit for multiple URLs. Each URL should point to an individual vehicle listing page.

**The `max_retries_per_url` parameter**: Sets retry attempts if pages fail to load or bot detection occurs. Default is 2, balancing thoroughness with efficiency.

**The `proxy` parameter**: Essential for avoiding detection. Egyptian residential proxies (`apifyProxyCountry: "EG"`) provide optimal access to ContactCars.com and ensure reliable data extraction.

#### Output Format

**Example output**

```json
[
  {
  "lowest_monthely_installment": 0,
  "lowest_insurrence_value": 1,
  "thumbnail": "UsedCars/4a9811dd-7955-4811-80fd-ebb88afb254b.jpeg",
  "installment_value": 0,
  "locations": [
    406
  ],
  "location": {
    "area_id": 406,
    "governorate_id": 1
  },
  "location_details": [
    {
      "area_id": 406,
      "governorate_id": 1
    }
  ],
  "title": "Cayenne suv",
  "extra_info": "Cayenne \n2019 \nSuv \n70.000 km\nFully loaded \nProtected",
  "engines": null,
  "lower_trusted_price": null,
  "insurance_premium": 0,
  "turbo": false,
  "warranty_years": null,
  "warranty_kilometers": null,
  "maintenance_table": null,
  "maintenance_cost": null,
  "user_rating": 0,
  "country": null,
  "email": null,
  "phone_unlocks": 0,
  "in_warranty": null,
  "offer_instalment": null,
  "contact_via_contact_messages": null,
  "factory_paint": true,
  "show_email": true,
  "show_telephones": true,
  "owner_installment_acceptance": null,
  "created_at": "2025-10-30T12:39:36.339226Z",
  "approved_date": "2025-10-30T12:39:38.627259Z",
  "users_count": null,
  "wheel_drive_type": null,
  "dealer_branche_id": 439,
  "available_online": false,
  "vin_number": null,
  "is_premium": false,
  "dealer": {
    "dealer_id": 1519365,
    "name": "2M Motors",
    "dealer_type": 3,
    "logo": "Dealers/2mmotors_logo_768149.png",
    "phone": "01115223300",
    "show_logo": true
  },
  "comment": null,
  "colors": null,
  "fuel_type_id": 1,
  "imported": false,
  "immediate_delivery": null,
  "premium_reposting_date": "2025-11-09T12:39:38.627238Z",
  "additional_info": {
    "in_warranty": null,
    "imported": false,
    "factory_paint": true,
    "almost_new": false,
    "for_disabled": false,
    "for_exchange": false,
    "installments_continued": false,
    "crashes": false,
    "taxi": false,
    "agency_maintenance": null,
    "new_tires": null,
    "new_brake_pads": null,
    "recent_maintenance": null,
    "first_owner": null,
    "seller_owned_license": null,
    "protection_film": null,
    "nano_ceramic": null
  },
  "down_payment_percentage": 30,
  "top_deal_feature": null,
  "expire_date": "2026-01-28T12:39:38.627259Z",
  "battery_capacity": null,
  "cylinder_count": 6,
  "contact_min_down_payment_percentage": null,
  "contact_max_installment_month": null,
  "contact_downpayment_limit": null,
  "contact_lowest_installment": 0,
  "id": "f0b477311edb",
  "album": [
    "UsedCars/4a9811dd-7955-4811-80fd-ebb88afb254b.jpeg",
    "UsedCars/f73401ce-c9d3-4b55-a8ed-c5b5b1c75a46.jpeg",
    "UsedCars/05a2b4f9-98c9-4374-97ad-49ba0e9fa55d.jpeg",
    "UsedCars/4381b41d-530f-411c-b730-7b4961a5f969.jpeg",
    "UsedCars/c18e865a-2d6a-405d-9d48-fd234214b925.jpeg",
    "UsedCars/67f0184a-7f0c-4cec-8024-68a9bf061776.jpeg",
    "UsedCars/eb54b005-ba27-48b2-b92c-c02d7fa0f3f9.jpeg",
    "UsedCars/6a4c3f90-29e3-46be-95d2-311c4c331eb1.jpeg",
    "UsedCars/eb3ad93a-415a-43f3-92ff-c57c41c3bd1b.jpeg",
    "UsedCars/903ac6e2-0e7f-46c9-a9aa-f7a94f0e2fea.jpeg",
    "UsedCars/8abe539f-6d98-4e02-aa94-9c8cda680d64.jpeg"
  ],
  "request_state": 2,
  "make_id": 40,
  "model_id": 205,
  "year": 2019,
  "price": 4500000,
  "body_shape_id": 8,
  "kilometers": 70000,
  "transmission_id": 2,
  "car_status": 3,
  "minimum_installment": null,
  "car_specs": null,
  "engine_capacity": 19,
  "color_id": 13,
  "engine": null,
  "engine_description": null,
  "owner_id": 2355874,
  "can_be_inspected": null,
  "is_trade_in": false,
  "is_customized_specs": false,
  "telephones": [
    "01200888166"
  ],
  "telephone": "01115223300",
  "whatsapp_number": null,
  "is_downpayment": true,
  "contact_downpayment_amount": null,
  "downpayment_amount": 1350000,
  "accept_contact_installment": true,
  "battery_power": null,
  "make": {
    "logo": "Makes/53bb2a31-2f39-4bd2-8656-4ba6377e0ee6_202106172141260824.jpg",
    "authorized_agent": {
      "logo": "Makes/7e33511c-b910-4fb3-8dbb-fe55fdbfecd1_202204201420445110.jpg",
      "id": 16,
      "name_ar": "إس. إم. جى",
      "name_en": "S.M.G"
    },
    "id": 40,
    "name_ar": "بورش",
    "name_en": "Porsche"
  },
  "model": {
    "make_id": 40,
    "model360_url": "null",
    "origin_country": null,
    "assembly_country": null,
    "id": 205,
    "name_ar": "كايين",
    "name_en": "Cayenne"
  },
  "car_documents": null,
  "album360": null,
  "clicks_counter": {
    "whats_app_number_clicks": 2,
    "call_clicks": 2,
    "share_clicks": 23,
    "comparison_clicks": 0
  },
  "market_price": null,
  "hide_price": false,
  "price_negotiable": true,
  "area": {
    "parent_id": 1,
    "id": 406,
    "name_ar": "التجمع الخامس والقاهرة الجديدة",
    "name_en": "New Cairo & 5th Settlement"
  },
  "goverorate": {
    "parent_id": 0,
    "id": 1,
    "name_ar": "القاهرة",
    "name_en": "Cairo"
  },
  "body_shape": {
    "logo": "https://contactcars.fra1.cdn.digitaloceanspaces.com/contactcars-production/Assets/Assets/ShapeTypes/suv.png",
    "sorting": 3,
    "id": 8,
    "name_ar": "SUV",
    "name_en": "SUV"
  },
  "transmission": {
    "logo": "https://contactcars.fra1.cdn.digitaloceanspaces.com/contactcars-production/Assets/Assets/TransmissionTypes/automatic.png",
    "id": 2,
    "name_ar": "اتوماتيك",
    "name_en": "Automatic"
  },
  "engine_capacity_data": {
    "sorting": 7,
    "id": 19,
    "name_ar": "3000",
    "name_en": "3000"
  },
  "fuel_type": {
    "id": 1,
    "name_ar": "بنزين",
    "name_en": "Gas"
  },
  "color": {
    "hex": "#FFFFFF",
    "id": 13,
    "name_ar": "أبيض",
    "name_en": "White"
  },
  "status": 3
}
]
```

The scraper extracts comprehensive vehicle data across multiple categories:

##### Pricing & Financial Data

- **Price**: Listed vehicle price. *Core value for market analysis, pricing comparisons, and investment decisions.*
- **Market Price**: Reference market value. *Enables assessment of deal quality and price positioning.*
- **Lowest Monthly Installment**: Minimum monthly payment option. *Critical for affordability analysis and financing comparisons.*
- **Installment Value**: Full installment amount details. *Provides complete financing cost structure.*
- **Down Payment Percentage**: Required upfront payment percentage. *Essential for buyer qualification and financing planning.*
- **Downpayment Amount**: Actual downpayment value. *Concrete figure for financial planning.*
- **Contact Downpayment Amount**: Dealer-specific downpayment options. *Shows dealer flexibility on financing terms.*
- **Contact Min Down Payment Percentage**: Minimum acceptable downpayment. *Reveals negotiation boundaries.*
- **Contact Max Installment Month**: Maximum financing term available. *Defines financing flexibility.*
- **Minimum Installment**: Lowest possible monthly payment. *Critical for budget-conscious buyers.*
- **Accept Contact Installment**: Whether dealer accepts installment plans. *Filters financing-friendly dealers.*
- **Owner Installment Acceptance**: Private seller financing willingness. *Indicates negotiation opportunities.*

##### Insurance & Warranty

- **Lowest Insurance Value**: Minimum insurance cost estimate. *Important for total ownership cost calculation.*
- **Insurance Premium**: Full insurance premium details. *Essential for budget planning.*
- **In Warranty**: Current warranty status. *Affects purchase value and risk assessment.*
- **Warranty Years**: Warranty duration remaining. *Key value indicator for used vehicles.*
- **Warranty Kilometers**: Warranty coverage by mileage. *Critical for high-mileage buyers.*

##### Vehicle Specifications

- **Make**: Vehicle manufacturer. *Primary categorization for market segmentation.*
- **Make ID**: Manufacturer identifier. *Database reference for make tracking.*
- **Model**: Specific vehicle model. *Essential for model-specific analysis.*
- **Model ID**: Model identifier. *Database reference for model tracking.*
- **Year**: Manufacturing year. *Critical for age-based valuation.*
- **Body Shape**: Vehicle body type. *Enables category-based filtering.*
- **Body Shape ID**: Body type identifier. *Standardized categorization.*
- **Kilometers**: Odometer reading. *Key indicator of vehicle condition and value.*
- **Car Status**: New or used designation. *Fundamental classification for market analysis.*
- **Transmission**: Transmission type. *Important buyer preference factor.*
- **Transmission ID**: Transmission identifier. *Standardized transmission tracking.*

##### Engine & Performance

- **Engine**: Engine designation. *Technical specification for performance assessment.*
- **Engine Description**: Detailed engine information. *Comprehensive technical details.*
- **Engine Capacity**: Engine displacement. *Key performance indicator.*
- **Engine Capacity Data**: Structured capacity information. *Detailed technical specifications.*
- **Engines**: Multiple engine configuration data. *For vehicles with engine options.*
- **Cylinder Count**: Number of cylinders. *Performance and efficiency indicator.*
- **Fuel Type**: Gasoline, diesel, hybrid, electric. *Operating cost factor.*
- **Fuel Type ID**: Fuel type identifier. *Standardized fuel classification.*
- **Turbo**: Turbocharger presence. *Performance enhancement indicator.*
- **Battery Capacity**: Electric vehicle battery size. *Critical for EV range estimation.*
- **Battery Power**: Battery output specifications. *Performance metric for electric vehicles.*
- **Wheel Drive Type**: 2WD, 4WD, AWD designation. *Capability and terrain suitability.*

##### Vehicle Condition & Features

- **Car Specs**: Specifications level (base, premium). *Trim level indicator.*
- **Is Customized Specs**: Custom modification indicator. *Shows non-standard configurations.*
- **Factory Paint**: Original paint condition. *Affects value and condition assessment.*
- **Colors**: Available color options. *Aesthetic preference data.*
- **Color**: Current vehicle color. *Visual characteristic.*
- **Color ID**: Color identifier. *Standardized color tracking.*
- **Imported**: Import status. *Origin indicator affecting value.*
- **VIN Number**: Vehicle identification number. *Unique vehicle identifier for history checks.*
- **Can Be Inspected**: Professional inspection availability. *Quality assurance option.*

##### Dealer & Contact Information

- **Dealer**: Dealer name or identification. *Source tracking for dealer analysis.*
- **Dealer Branche ID**: Specific branch identifier. *Location-specific dealer tracking.*
- **Owner ID**: Listing owner identifier. *Seller tracking for inventory analysis.*
- **Email**: Contact email address. *Direct communication channel.*
- **Show Email**: Email visibility setting. *Contact preference indicator.*
- **Telephones**: Contact phone numbers. *Primary communication channel.*
- **Telephone**: Main phone number. *Direct contact method.*
- **Show Telephones**: Phone visibility setting. *Contact preference indicator.*
- **Whatsapp Number**: WhatsApp contact. *Modern communication channel.*
- **Phone Unlocks**: Phone visibility unlock count. *Engagement metric.*
- **Contact Via Contact Messages**: Platform messaging availability. *Alternative contact method.*

##### Location Data

- **Locations**: Multiple location data. *For multi-location dealers.*
- **Location**: Primary vehicle location. *Geographic positioning.*
- **Location Details**: Detailed location information. *Precise location data.*
- **Area**: Specific area designation. *Local geographic detail.*
- **Governorate**: Egyptian governorate. *Regional classification.*
- **Country**: Country designation. *International context.*

##### Listing Metadata

- **ID**: Unique listing identifier. *Database primary key.*
- **Title**: Listing headline. *Primary listing description.*
- **Extra Info**: Additional listing information. *Supplementary details.*
- **Additional Info**: Extended information fields. *Comprehensive listing data.*
- **Comment**: Seller comments. *Qualitative information.*
- **Created At**: Listing creation date. *Age tracking for analysis.*
- **Approved Date**: Listing approval timestamp. *Publication timing.*
- **Expire Date**: Listing expiration date. *Urgency indicator.*
- **Request State**: Listing status. *Processing stage tracking.*

##### Market Intelligence

- **Clicks Counter**: View count. *Popularity and demand indicator.*
- **Users Count**: Interested users. *Engagement metric.*
- **User Rating**: Seller rating. *Reputation indicator.*
- **Is Premium**: Premium listing status. *Visibility indicator.*
- **Premium Reposting Date**: Premium renewal date. *Listing strategy tracking.*
- **Top Deal Feature**: Featured deal status. *Promotional indicator.*
- **Available Online**: Online availability status. *Immediate purchase readiness.*
- **Immediate Delivery**: Fast delivery capability. *Logistics indicator.*

##### Maintenance & Documentation

- **Maintenance Table**: Service history structure. *Maintenance record tracking.*
- **Maintenance Cost**: Service cost estimates. *Ongoing ownership cost.*
- **Car Documents**: Documentation status. *Legal compliance indicator.*

##### Advanced Features

- **Album**: Photo gallery. *Visual documentation.*
- **Album360**: 360-degree view availability. *Enhanced visualization.*
- **Thumbnail**: Preview image. *Visual identification.*
- **Is Trade In**: Trade-in acceptance. *Purchase flexibility indicator.*
- **Is Downpayment**: Downpayment requirement. *Financing structure.*
- **Offer Instalment**: Installment offer availability. *Financing option.*
- **Hide Price**: Price visibility setting. *Negotiation strategy indicator.*
- **Price Negotiable**: Negotiation possibility. *Pricing flexibility.*
- **Status**: Current listing status. *Active/inactive indicator.*

Each field provides specific value for market analysis, vehicle comparison, dealer intelligence, or buyer decision-making in the Egyptian automotive market.

### Usage Guide

#### Setting Up Your Scraping Task

**Step 1: Identify Target Vehicles**

Browse ContactCars.com to find vehicles matching your research criteria:

- Search by make, model, price range, or location
- Filter by specifications, year, or condition
- Navigate to individual vehicle detail pages
- Copy URLs from browser address bar

**Step 2: Configure Input JSON**

Add collected URLs to the `urls` array. Include multiple URLs for batch processing or comparative analysis across different vehicles, dealers, or market segments.

**Step 3: Configure Proxy Settings**

For ContactCars.com scraping:

- Enable Apify proxy with residential options
- Set `apifyProxyCountry` to `"EG"` for Egyptian proxies
- Ensures reliable access and reduces detection risk

**Step 4: Set Retry Limits**

Configure `max_retries_per_url` based on needs:

- Default of 2 balances thoroughness with speed
- Increase for mission-critical data collection
- Reduce for fast exploratory analysis

#### Best Practices

**URL Collection Strategy:**

- Organize URLs by vehicle category or price segment
- Test individual URLs before batch processing
- Verify URLs point to active, available listings
- Keep backup copies of working URLs

**Proxy Management:**

- Egyptian residential proxies provide best results
- Monitor for access issues or blocks
- Adjust proxy settings if encountering restrictions
- Consider request timing for large batches

**Data Validation:**

- Cross-reference extracted prices with platform display
- Verify contact information accuracy
- Check specification completeness
- Validate location and dealer data

**Efficient Processing:**

- Group similar vehicles for streamlined analysis
- Process high-priority listings first
- Schedule large extraction jobs during off-peak hours
- Monitor extraction progress for failures

#### Common Troubleshooting

**Access Issues:**

- Switch to Egyptian residential proxies
- Increase retry limits for unstable connections
- Verify URLs are correctly formatted
- Check for temporary platform restrictions

**Data Completeness:**

- Some fields may be empty for basic listings
- Premium listings typically have more complete data
- Verify source page contains expected information
- Check for platform structure changes

**URL Problems:**

- Ensure URLs point to English language pages
- Verify listing IDs are valid and active
- Check for URL parameter changes
- Test URLs in browser before scraping

### Benefits and Applications

The ContactCars.com Car Details Scraper dramatically reduces research time while providing comprehensive vehicle intelligence from Egypt's automotive marketplace.

**Primary Applications:**

**Automotive Dealer Competitive Analysis:** Monitor competitor pricing, inventory, financing terms, and market positioning. Track dealer-specific strategies and identify market opportunities.

**Market Price Research:** Build comprehensive pricing databases for specific makes and models, analyze price trends over time, identify undervalued or overpriced listings, and establish market value benchmarks.

**Vehicle Comparison & Due Diligence:** Compare specifications, pricing, and conditions across multiple vehicles. Verify VIN numbers, check warranty status, and assess maintenance history before purchase decisions.

**Financing Analysis:** Research available financing options, compare installment plans across dealers, analyze downpayment requirements, and identify best financing terms.

**Market Intelligence:** Track listing durations, monitor dealer inventory turnover, analyze demand through click counters, and identify trending vehicle categories.

**Automotive Database Building:** Create comprehensive vehicle databases for resale platforms, develop pricing tools and calculators, build market analysis applications, and maintain updated automotive intelligence.

**Key Advantages:**

- Complete extraction of 90+ data fields per vehicle
- Financial data including pricing, installments, and insurance
- Technical specifications covering all vehicle characteristics
- Dealer contact and reputation information
- Warranty and maintenance cost data
- Market intelligence metrics (clicks, ratings, engagement)

The structured output integrates with automotive CRM systems, pricing tools, market analysis platforms, and business intelligence applications for immediate activation in automotive business operations.

### Conclusion

The ContactCars.com Car Details Scraper transforms manual vehicle research into automated intelligence gathering from Egypt's leading automotive marketplace. By extracting comprehensive vehicle data including pricing, specifications, dealer information, and financing details, it enables data-driven decisions for automotive professionals and serious car buyers.

Whether you're conducting market analysis, comparing vehicle options, monitoring dealer competition, or building automotive databases, this scraper provides the systematic extraction capabilities needed to accelerate your automotive intelligence operations.

Ready to streamline your Egyptian automotive market research? Start extracting comprehensive vehicle insights from ContactCars.com today.

## Related Actors

- [**contactcars.com Cars Search Scraper**](https://apify.com/ecomscrape/contactcars-cars-search-scraper): A specialized data extraction tool engineered to harvest detailed cars information from contactcars's cars marketplace.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about contactcars.com Automotive Details Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific cars urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.contactcars.com/en/used-cars/porsche-cayenne/f0b477311edb"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

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

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.contactcars.com/en/used-cars/porsche-cayenne/f0b477311edb"
    ],
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/contactcars-cars-details-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.contactcars.com/en/used-cars/porsche-cayenne/f0b477311edb"],
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/contactcars-cars-details-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.contactcars.com/en/used-cars/porsche-cayenne/f0b477311edb"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/contactcars-cars-details-scraper --silent --output-dataset

```

## MCP server setup

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

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

## OpenAPI specification

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