# TrueCar Used Cars Search Scraper (`ecomscrape/truecar-used-cars-search-scraper`) Actor

Automate used car data extraction from TrueCar.com with comprehensive vehicle details, pricing information, dealer data, and market analysis. Perfect for automotive dealers, market researchers, and price comparison platforms seeking systematic access to TrueCar's extensive used car inventory.

- **URL**: https://apify.com/ecomscrape/truecar-used-cars-search-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Automation, E-commerce, Developer tools
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 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)

## TrueCar.com Used Cars Scraper: Extract Vehicle Listings & Pricing Data for Automotive Market Analysis

### Introduction

TrueCar.com stands as one of America's leading automotive marketplaces, providing transparent pricing and comprehensive vehicle information for car buyers. With thousands of dealerships and hundreds of thousands of used car listings, TrueCar aggregates extensive automotive data including vehicle specifications, pricing trends, dealer information, and market valuations.

For automotive professionals, market researchers, competitive intelligence teams, and price comparison services, accessing TrueCar's structured vehicle data is essential for market analysis, pricing strategies, and inventory management. However, manually collecting vehicle listings across different makes, models, and locations is extremely time-consuming and impractical for large-scale analysis.

The TrueCar Used Cars Scraper automates this data extraction process, enabling systematic collection of vehicle listings with complete specifications, pricing details, dealer information, and market analysis data. Whether analyzing SUV pricing trends, tracking dealer inventory, or building automotive databases, this scraper transforms hours of manual research into minutes of automated data collection.

### Scraper Overview

The TrueCar Used Cars Scraper is a specialized automotive data extraction tool designed to systematically collect used vehicle listings from TrueCar's comprehensive marketplace. Using advanced web automation, it navigates search results and extracts detailed vehicle profiles with pricing, specifications, dealer information, and market insights.

Key advantages include residential proxy support for reliable access, configurable retry mechanisms for handling network issues, and flexible pagination controls for managing large vehicle datasets. It's particularly valuable for automotive dealers monitoring competition, market analysts tracking pricing trends, inventory managers analyzing stock levels, and automotive data companies building comprehensive vehicle databases.

The scraper handles various search parameters including vehicle type filters, sorting preferences (best deal, price, mileage, year), and custom pagination controls. It maintains high data accuracy while implementing ethical scraping practices and rate limiting.

### Input and Output Details

Example url 1: https://www.truecar.com/used-cars-for-sale/listings/body-suv/location-seattle-wa/?sort\[]=created_date_desc

Example url 2: https://www.truecar.com/used-cars-for-sale/listings/body-suv/location-seattle-wa/?page=3

Example url 3: https://www.truecar.com/used-cars-for-sale/listings/honda/civic/

Example Screenshot of automotive list by query page:

![](https://i.postimg.cc/vmS7bD4j/Screenshot-from-2026-01-08-17-04-43.png)

#### Input Format

##### Scrape with URLs:

```json
{
  "proxy": {
    "useApifyProxy": false
  },
  "ignore_url_failures": true,
  "max_retries_per_url": 2,
  "max_items_per_url": 20,
  "urls": [
    "https://www.truecar.com/used-cars-for-sale/listings/body-suv/?sort[]=best_deal_desc_script",
    "https://www.truecar.com/used-cars-for-sale/listings/honda/civic/",
    "https://www.truecar.com/used-cars-for-sale/listings/body-suv/location-seattle-wa/?page=3"
  ]
}
```

**The `urls` parameter**: Add URLs of TrueCar used car search pages you want to scrape. Paste URLs individually or use Bulk edit for prepared lists. Ideal when targeting specific vehicle searches or filtered results.

**The `ignore_url_failures` parameter**: If `true`, continues scraping even if some URLs fail after maximum retries. Prevents single problematic URLs from stopping entire extraction jobs.

*When providing URLs, all search filter options are disabled—only specified URLs will be scraped.*

##### Scrape with Search Filters:

```json
{
  "keyword": "Honda Accord",
  "sort_by": "best_deal_desc_script",
  "page": 1,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

**The `keyword` parameter**: Search term for vehicles (e.g., "Honda Accord", "SUV", "Toyota", "sedan"). Matches makes, models, or vehicle types.

**The `sort_by` parameter**: Controls result ordering:

- `"best_deal_desc_script"` - Best deals first
- `"price_asc"` - Price: Low to High
- `"price_desc"` - Price: High to Low
- `"distance_asc_script"` - Closest to Farthest
- `"mileage_asc"` - Mileage: Low to High
- `"mileage_desc"` - Mileage: High to Low
- `"year_asc"` - Year: Oldest to Newest
- `"year_desc"` - Year: Newest to Oldest
- `"created_date_desc"` - Newest listings first

**The `page` parameter**: Starting page number for scraping. Useful for resuming interrupted extractions or targeting specific result ranges.

*When using search filters, leave the `urls` field empty.*

##### General Options:

**The `max_items_per_url` parameter**: Limits items scraped per URL or search. Default: 20. Balances batch size with manageable data collection.

**The `max_retries_per_url` parameter**: Maximum retry attempts if scraping fails. Default: 2. Balances thoroughness with efficiency.

**The `proxy` parameter**: Essential for avoiding detection. Residential proxies recommended for TrueCar access. US-based proxies optimal for domestic vehicle listings.

#### Output Format

The scraper returns structured vehicle data with fields serving specific automotive intelligence purposes:

- **ID**: Unique TrueCar listing identifier. *Critical for tracking specific vehicles, preventing duplicates, and referencing listings across time.*

- **Is Multi Location**: Boolean indicating multi-location dealership availability. *Identifies dealer networks with multiple branches, useful for understanding dealer scale and reach.*

- **TCPlus Eligible**: TrueCar+ program eligibility indicator. *Shows premium listings with enhanced features, indicates dealer investment level.*

- **Distance Retailing**: Remote purchase/delivery capability indicator. *Identifies dealers offering contactless transactions and expanded geographic reach.*

- **Saved**: Vehicle save/favorite status. *Tracks user engagement signals, though typically empty for fresh scrapes.*

- **Gallery Images**: Array of vehicle photo URLs. *Essential for visual inspection, creating enriched listings, and assessing vehicle presentation quality.*

- **Partner Preferred**: Preferred partner dealer status. *Indicates TrueCar's top-rated dealers based on customer satisfaction and transaction volume.*

- **Prospect State**: Lead/prospect status information. *Shows dealer interest tracking, useful for understanding competitive dynamics.*

- **Pricing**: Comprehensive pricing data including list price, TrueCar valuation, savings estimates, payment options. *Core data for price analysis, market comparison, and deal evaluation.*

- **Precalculated Lease**: Pre-calculated lease payment information. *Enables lease vs. purchase analysis and financing strategy evaluation.*

- **Market Analysis**: TrueCar's market insights including price positioning vs. market average, deal rating, days on market. *Provides context for pricing strategies and competitive positioning.*

- **Dealership**: Complete dealer information including name, location, contact details, ratings, reviews. *Essential for dealer network analysis, contact management, and competitive intelligence.*

- **Vehicle**: Detailed vehicle specifications including make, model, year, trim, mileage, VIN, exterior/interior colors, features, fuel economy. *Core automotive data for inventory analysis, specification matching, and technical research.*

- **Condition History**: Vehicle history data including accidents, ownership, service records, title status. *Critical for quality assessment, risk evaluation, and value determination.*

Each field supports automotive market analysis, competitive pricing strategies, dealer intelligence, and comprehensive vehicle database development.

##### Example Output:

```json
[
  {
  "id": "Q29uc3VtZXJTdW1tYXJ5TGlzdGluZy1XTVdaQzVDNThFV1A0MDE0Mg==",
  "is_multi_location": false,
  "tcplus_eligible": false,
  "distance_retailing": false,
  "saved": false,
  "gallery_images": null,
  "partner_preferred": false,
  "prospect_state": null,
  "pricing": {
    "__typename": "ConsumerSummaryListingPricing",
    "list_price": 7295,
    "base_msrp": null,
    "total_msrp": null,
    "exclusion": "NO_EXCLUSION",
    "discount_label": null,
    "sub_total": null,
    "transfer_fee": null
  },
  "precalculated_lease": null,
  "market_analysis": {
    "__typename": "ConsumerSummaryMarketAnalysis",
    "price_quality": "EXCELLENT"
  },
  "dealership": {
    "__typename": "ListingDealership",
    "id": "TGlzdGluZ0RlYWxlcnNoaXAtNTQ1NTA0",
    "database_id": "545504",
    "name": "Auto Vendors",
    "parent_dealership_name": null,
    "location": {
      "__typename": "ListingDealershipLocation",
      "address1": "927 N Andrews Ave",
      "address2": null,
      "geolocation": {
        "__typename": "ListingGeolocation",
        "city": "Fort Lauderdale",
        "state": "FL",
        "postal_code": "33311"
      }
    }
  },
  "vehicle": {
    "__typename": "ListingVehicle",
    "condition": "USED",
    "exterior_color": "White",
    "interior_color": "Black",
    "engine": "1.6L Inline-4 Gas Turbocharged",
    "body_style": "SUV",
    "certified_pre_owned": false,
    "fuel_type": "Gas",
    "transmission": "Automatic",
    "vin": "WMWZC5C58EWP40142",
    "key_features": [
      "Premium Wheels",
      "Premium Seat Material",
      "Bluetooth"
    ],
    "mpg": {
      "__typename": "FuelEconomy",
      "combined": 27,
      "city": 25,
      "highway": 31
    },
    "make": {
      "__typename": "ListingMake",
      "database_id": "5",
      "name": "MINI",
      "slug": "mini"
    },
    "model": {
      "__typename": "ListingModel",
      "database_id": "2318",
      "name": "Countryman",
      "slug": "countryman"
    },
    "year": 2014,
    "mileage": 83057,
    "style": {
      "__typename": "ListingStyle",
      "name": "S ALL4",
      "database_id": "45357",
      "trim_name": "Cooper S ALL4",
      "drive_type": "ALL_WHEEL_DRIVE",
      "electric_range": null
    }
  },
  "condition_history": {
    "__typename": "ConsumerSummaryConditionHistory",
    "accident_count": 1,
    "owner_count": 2,
    "is_clean_title": true
  },
  "from_url": "https://www.truecar.com/used-cars-for-sale/listings/body-suv/?sort%5B%5D=best_deal_desc_script&page=1"
}
]
```

### Usage Guide

#### Option 1: Scraping with URLs

Navigate to TrueCar.com and construct targeted searches using filters for vehicle type, price range, location, and other criteria. Copy the resulting URL into the `urls` array. This method works best when targeting specific vehicle segments or pre-configured searches.

**Best practices:**

- Test URLs individually before batch processing
- Monitor for blocked requests during high-volume extraction
- Use residential proxies to avoid rate limiting
- Keep backup URLs as search structures may change
- Verify URL parameters persist across scraping sessions

**Troubleshooting:**

- Adjust proxy settings if encountering access restrictions
- Reduce retry counts for timeout issues
- Verify URL format matches current TrueCar structure
- Check for dynamic URL parameters that may expire

#### Option 2: Scraping with Search Filters

##### Setting Up Vehicle Search Criteria

**Step 1: Define Search Keyword**

Use the `keyword` parameter for vehicle searches:

- Specific models: "Honda Accord", "Toyota Camry", "Ford F-150"
- Makes: "BMW", "Mercedes-Benz", "Tesla"
- Vehicle types: "SUV", "sedan", "truck", "electric"
- Combinations: "luxury sedan", "compact SUV"

**Step 2: Configure Sorting**

Choose `sort_by` based on research objectives:

- **"best_deal_desc_script"**: Prioritizes vehicles with best value propositions—ideal for deal analysis
- **"price_asc"/"price_desc"**: Price-based sorting for budget analysis or luxury segment research
- **"mileage_asc"/"mileage_desc"**: Focus on low-mileage or high-mileage inventory analysis
- **"year_desc"/"year_asc"**: Target newest/oldest vehicles for vintage or current model research
- **"distance_asc_script"**: Geographic proximity sorting for location-based analysis
- **"created_date_desc"**: Track newest listings for inventory turnover analysis

**Step 3: Set Pagination**

Configure the `page` parameter:

- Start at `1` for complete dataset collection
- Use higher page numbers to resume interrupted scrapes
- Plan page ranges based on `max_items_per_url` setting
- Track total pages available for comprehensive coverage

##### Best Practices for Filter-Based Scraping

**Keyword Strategy:**

- Start broad ("SUV") then narrow ("compact SUV under $30k")
- Use manufacturer-specific terminology
- Test keywords on TrueCar before scraping
- Consider trim level variations for specific models

**Sorting for Analysis:**

- Use "best_deal" for value opportunity identification
- Use "price" sorting for market range analysis
- Use "created_date" for inventory velocity tracking
- Combine multiple sorts in separate scrapes for comprehensive data

**Systematic Coverage:**

1. Define vehicle segments of interest
2. Run searches with different sort orders
3. Track pagination to avoid gaps
4. Schedule regular scrapes for market updates
5. Store data with timestamps for trend analysis

##### Data Validation and Quality Control

Verify extracted data:

- Vehicle specifications match search criteria
- Pricing data is complete and current
- Dealer information includes contact details
- VINs are valid and properly formatted
- Images are accessible and vehicle-relevant
- Market analysis data is present for comparisons

##### Common Issue Resolution

**Access Problems:**

- Switch to residential proxies for better success rates
- Use US-based proxies for domestic listings
- Adjust retry settings for better reliability
- Verify TrueCar hasn't changed site structure

**Search Issues:**

- Test keywords directly on TrueCar website first
- Verify sort parameters match current options
- Check page numbers don't exceed available results
- Ensure filter combinations are valid

**Data Quality:**

- Cross-reference VINs with external databases
- Verify pricing data against market benchmarks
- Check dealer information accuracy
- Validate mileage and year combinations

##### Advanced Scraping Techniques

**Market Segmentation Analysis:**

- Run parallel scrapes for different vehicle types
- Compare pricing across makes/models
- Track inventory levels by segment
- Identify market trends and gaps

**Competitive Intelligence:**

- Monitor specific dealer inventories
- Track pricing changes over time
- Analyze dealer network coverage
- Identify market positioning strategies

**Pricing Strategy Research:**

- Collect data across multiple sort orders
- Compare "best deal" flagged vehicles
- Analyze price vs. market average trends
- Track days-on-market correlations with pricing

#### Proxy Configuration

**Residential Proxies:**

- Essential for TrueCar access reliability
- Reduces detection and blocking risks
- Enables higher-volume data collection
- Provides geographic flexibility

**US Proxy Benefits:**

- Optimal for domestic vehicle listings
- Better access to regional inventory
- Improved response times
- Matches typical user geographic patterns

### Benefits and Applications

The TrueCar Used Cars Scraper dramatically reduces research time, transforming days of manual vehicle data collection into hours of automated extraction. This efficiency enables automotive professionals to focus on analysis and strategy rather than data gathering.

**Primary Applications:**

**Automotive Dealer Intelligence:** Monitor competitor inventory, pricing strategies, and market positioning. Track regional pricing variations and identify competitive opportunities.

**Market Research & Analysis:** Analyze pricing trends across vehicle segments, assess market demand by vehicle type, and identify emerging market opportunities in used automotive sales.

**Inventory Management:** Track vehicle availability across dealerships, monitor days-on-market trends, and optimize inventory mix based on market data.

**Price Comparison Services:** Build comprehensive vehicle pricing databases, provide consumers with market insights, and develop value recommendation algorithms.

**Automotive Data Platforms:** Create enriched vehicle databases, power recommendation engines, and support automotive research applications.

**Competitive Advantages:**

- Access to comprehensive vehicle specifications and pricing data
- Market analysis insights including deal ratings and price positioning
- Dealer network intelligence with ratings and reviews
- Vehicle history and condition data for quality assessment
- Scalable collection supporting single vehicles to entire market segments

Structured output integrates with automotive CRM systems, pricing tools, inventory management platforms, and business intelligence applications.

### Conclusion

The TrueCar Used Cars Scraper transforms manual automotive data collection into efficient automated extraction. By providing systematic access to TrueCar's extensive vehicle marketplace data, it empowers dealers, market researchers, and automotive data companies to make informed decisions about pricing, inventory, and market strategy.

Whether building comprehensive vehicle databases, monitoring competitive pricing, analyzing market trends, or developing automotive applications, this scraper provides the systematic data extraction needed to accelerate automotive intelligence gathering.

Ready to streamline your automotive data collection? Start extracting valuable vehicle insights from TrueCar's marketplace today and transform your automotive market research capabilities.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about truecar.com Property Search 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 Used Cars list page 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 after the maximum number of retries is reached.

## `keyword` (type: `string`):

Enter the keyword to search for items

## `sort_by` (type: `string`):

Filter items by (e.g., best_deal_desc_script, price_asc, price_desc, distance_asc_script, mileage_asc, mileage_desc, year_asc, year_desc, created_date_desc)

## `page` (type: `integer`):

Specify the page number to start scraping from

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL or search filters you want to scrape

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

Limit the number of retries for each URL or search filters 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.truecar.com/used-cars-for-sale/listings/body-suv/?sort[]=best_deal_desc_script"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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.truecar.com/used-cars-for-sale/listings/body-suv/?sort[]=best_deal_desc_script"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/truecar-used-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.truecar.com/used-cars-for-sale/listings/body-suv/?sort[]=best_deal_desc_script"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/truecar-used-cars-search-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.truecar.com/used-cars-for-sale/listings/body-suv/?sort[]=best_deal_desc_script"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call ecomscrape/truecar-used-cars-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/truecar-used-cars-search-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/fxQuQT4F9y2u0mYSA/builds/IEyvi9n9Avo7X0kJt/openapi.json
