# Cargurus Com Cars Search Scraper (`stealth_mode/cargurus-com-cars-search-scraper`) Actor Scrape CarGurus.com search results and extract 40+ fields per listing — including price, deal rating, seller info, VIN, mileage, and EV data. Perfect for dealers, analysts, and automotive researchers needing structured car inventory data fast. - **URL**: https://apify.com/stealth\_mode/cargurus-com-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 ## CarGurus.com Car Search Scraper: Extract Auto Listings at Scale --- ### What Is CarGurus.com? CarGurus is one of the largest automotive marketplaces in the US, aggregating millions of new and used car listings from dealerships and private sellers. Its proprietary Deal Rating system scores each listing based on market value — making its data especially valuable for price analysis and competitive research. Manually collecting this data at scale is impractical; the **CarGurus Car Search Scraper** automates extraction from search result pages directly. --- ### Overview The **CarGurus Search Scraper** processes CarGurus search result URLs and returns rich, structured records for each vehicle listing. It is suited for: - **Auto dealers** monitoring competitor pricing and inventory - **Market analysts** tracking price trends by make, model, or region - **Data aggregators** building used/new car comparison platforms - **EV researchers** analyzing electric vehicle availability and pricing --- ### Input Format ```json { "urls": [ "https://www.cargurus.com/search?bodyTypeGroupIds=7&isDeliveryEnabled=false&priceDropsOnly=false&hideNationwideShipping=true&sourceContext=carGurusHomePageModel&page=2&pageAlignment=eyJmaXJzdFBhZ2UiOjE4LCJwYWdlTiI6MjF9" ], "ignore_url_failures": true, "max_items_per_url": 20 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more CarGurus **search result** page URLs. Supports bulk entry. Use the search filters on CarGurus (body type, price range, zip code, etc.) to build targeted URLs before pasting here. | | `ignore_url_failures` | `boolean` | If `true`, the scraper skips failed URLs and continues the run instead of stopping. Recommended for bulk jobs. Default: `true`. | | `max_items_per_url` | `integer` | Maximum listings to collect per URL. Useful for controlling run size. Default: `20`. | > **Tip:** Build your search URL directly on CarGurus using filters (body type, year range, distance, price), then copy the URL from your browser. Each unique filter combination produces a distinct, scrapeable URL. *** ### Output Format **Sample output** ```json { "id": 447868611, "area_boost_data": {}, "buying_option": "CONVERT", "compliance": {}, "days_on_market": null, "deal_rating": "FAIR_PRICE", "deal_score": 2.1686568, "debug_info": " / rank #: 27 / sellerId: 2302630 / spId: 279978 / Paid Dealer: true / active partners: 403", "distance": 6.4792204, "exterior_color_data": { "name": "Bright White Clearcoat", "localized": "Bright White Clearcoat", "normalized": "WHITE" }, "ev_battery_data": {}, "finance_data": { "approved_apps_for_finance_wizard": {}, "financing_eligibility_lookup": [ "GLS", "CAPITAL_ONE" ], "is_eligible_for_financing": false }, "fuel_data": { "city_economy": 24, "combined_economy": 27.6, "highway_economy": 32, "localized_combined_economy": "28 MPG", "localized_type": "Gasoline", "unit": "MPG" }, "how_to_shop": "PICK_UP_ONLY", "inclusion_type": "DEFAULT", "interior_color_data": { "name": "Black", "localized": "Black", "normalized": "BLACK" }, "is_cpo": false, "is_new": false, "listing_source": "dealercue-1", "listing_title": "2024 Jeep Compass Latitude 4WD", "localized_doors": "4 doors", "localized_drivetrain": "Four-Wheel Drive", "localized_engine_name": "200 hp 2L I4", "localized_mileage": "53,936", "localized_transmission": "8-Speed Automatic", "mileage_data": { "value": 53936, "unit": "MILES" }, "offset": 0, "ontology_data": { "entity_id": "t108812", "make_id": "m32", "make_name": "Jeep", "model_id": "d905", "model_name": "Compass", "car_year": "2024", "trim_name": "Latitude 4WD", "body_type_group_id": "bg7", "body_type_name": "SUV / Crossover" }, "picture_data": { "url": "https://static.cargurus.com/images/forsale/2026/05/12/20/46/2024_jeep_compass-pic-1479963629330944615-1024x768.jpeg", "height": 681, "width": 1024 }, "picture_count": 35, "price_data": { "current": 19995, "total_price": 20191, "differential": 161, "expected": 20156, "localized_differential": "$161", "localized_price": "$19,995", "localized_total_price": "$20,191", "is_fees_compliant": true }, "safety_rating": "Not Rated", "seller_data": { "city": "West Seneca", "display_location": "West Seneca, NY", "google_static_map_url": "https://www.google.com/maps/dir/?api=1&destination=Galaxy+Auto+Place+2338+Union+Road%2CWest+Seneca+NY%2C+14224%2CUS", "is_sms_supported": true, "listing_partner_id": 403, "localized_phone_number": "(716) 356-3197", "logo_url": "https://static.cargurus.com/images/site/2017/10/17/10/57/galaxy_auto_place-pic-4905015745120588646-200x200.jpeg", "phone_number": "+1 716-356-3197", "phone_number_sms": "+18883346545", "postal_code": "14224", "region": "NY", "sales_status": "PAYING", "seller_id": 2302630, "service_provider_id": "279978", "service_provider_name": "Galaxy Auto Place" }, "sort_score": null, "stock_number": "21365", "store_transfer_data": {}, "vehicle_features": [ "Leather Seats", "Alloy Wheels", "Bluetooth", "Backup Camera", "Remote Start", "Blind Spot Monitoring", "Parking Sensors", "Android Auto", "Quick Order Package", "CarPlay", "Multi Zone Climate Control" ], "vin": "3C4NJDBN0RT117497", "imv_price": 20156, "greatest_deal_eligible": false } ``` Each listing returns up to 40+ structured fields: #### Core Identification | Field | Meaning | |---|---| | `ID` | Unique CarGurus listing identifier | | `VIN` | Vehicle Identification Number — globally unique per vehicle | | `Stock Number` | Dealer's internal inventory stock number | | `Listing Title` | Full title as shown on search results (e.g., *2021 Toyota Camry SE*) | | `Listing Source` | Origin of the listing (dealer, private seller, etc.) | | `Inclusion Type` | How the listing was included in results (organic, featured, etc.) | | `Is New` | `true` if the vehicle is new; `false` if used | | `Is CPO` | `true` if Certified Pre-Owned | #### Pricing & Deal Intelligence | Field | Meaning | |---|---| | `Price Data` | Full price object including asking price, currency, and formatted display | | `IMV Price` | CarGurus' Instant Market Value — the estimated fair market price for this vehicle | | `Deal Rating` | Human-readable deal quality label (e.g., *Great Deal*, *Fair Deal*, *Overpriced*) | | `Deal Score` | Numerical score underlying the Deal Rating | | `Greatest Deal Eligible` | Whether the listing qualifies for CarGurus' top deal badge | | `Finance Data` | Estimated monthly payment and financing details | #### Vehicle Specs | Field | Meaning | |---|---| | `Localized Mileage` | Odometer reading formatted for the user's locale (e.g., *32,000 mi*) | | `Localized Engine Name` | Engine description (e.g., *2.5L 4-Cylinder*) | | `Localized Drivetrain` | Drivetrain type (e.g., *AWD*, *FWD*) | | `Localized Transmission` | Transmission type (e.g., *Automatic*, *Manual*) | | `Localized Doors` | Number of doors | | `Mileage Data` | Raw mileage object with unit and value | | `Fuel Data` | Fuel type, economy ratings (MPG/MPGe) | | `EV Battery Data` | For electric vehicles: battery capacity, range, charge type | | `Vehicle Features` | List of notable features and packages | | `Safety Rating` | NHTSA or IIHS safety score where available | | `Ontology Data` | Structured classification: make, model, trim, year | #### Appearance | Field | Meaning | |---|---| | `Exterior Color Data` | Exterior color name and hex/color group | | `Interior Color Data` | Interior color and material description | | `Picture Data` | Array of image URLs for the listing | | `Picture Count` | Total number of photos available | #### Seller & Location | Field | Meaning | |---|---| | `Seller Data` | Dealer or private seller name, address, phone, rating | | `Distance` | Distance from the search origin zip code | | `Buying Option` | Purchase methods available (e.g., online, in-person, delivery) | | `How To Shop` | CarGurus shopping workflow flags (e.g., home delivery eligible) | | `Store Transfer Data` | Whether the vehicle can be transferred from another lot | | `Area Boost Data` | Whether the listing was boosted into results from outside the search radius | #### Listing Metadata | Field | Meaning | |---|---| | `Days On Market` | How long the listing has been active | | `Offset` | Position offset within the search results page | | `Sort Score` | Internal relevance/sort ranking score | | `Compliance` | Regulatory or legal compliance flags | | `Debug Info` | Internal diagnostic metadata (useful for troubleshooting scraper runs) | *** ### How to Use 1. **Build your search URL** — Go to CarGurus.com, apply filters (body type, zip code, price, year), and copy the resulting URL from your browser. 2. **Paste into `urls`** — Add one or more search page URLs to the array. Each page typically contains 15–25 listings. 3. **Set limits** — Use `max_items_per_url` to cap collection volume per URL. 4. **Enable fault tolerance** — Keep `ignore_url_failures: true` for multi-URL runs. 5. **Export** — Download results as JSON, CSV, or Excel. **Common issues:** - If results seem empty, verify the URL is a **search results page**, not a single listing detail page. - Pagination is embedded in the URL (`page=2`, `pageAlignment=...`) — increment page numbers to collect additional results. - For geo-targeted results, build your URL with a specific zip code filter on CarGurus before copying. *** ### Use Cases & Business Value - **Dealer benchmarking:** Compare your inventory pricing against local competitors in real time - **Price trend analysis:** Track average prices by make/model over time using IMV and Deal Score - **EV market research:** Extract battery range, pricing, and availability data across electric inventory - **Lead generation platforms:** Power car comparison tools with live structured inventory data The scraper replaces hours of manual browsing with a single automated run, delivering consistent data that feeds directly into dashboards, spreadsheets, or pricing engines. *** ### Conclusion The **CarGurus Car Search Scraper** turns one of the web's most data-rich automotive marketplaces into a structured, queryable dataset. With 40+ fields per listing — from VIN and IMV pricing to EV battery specs and deal scores — it provides everything needed for serious automotive data work. 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.cargurus.com/search?bodyTypeGroupIds=7&isDeliveryEnabled=false&priceDropsOnly=false&hideNationwideShipping=true&sourceContext=carGurusHomePageModel&page=2&pageAlignment=eyJmaXJzdFBhZ2UiOjE4LCJwYWdlTiI6MjF9" ], "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.cargurus.com/search?bodyTypeGroupIds=7&isDeliveryEnabled=false&priceDropsOnly=false&hideNationwideShipping=true&sourceContext=carGurusHomePageModel&page=2&pageAlignment=eyJmaXJzdFBhZ2UiOjE4LCJwYWdlTiI6MjF9" ], "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/cargurus-com-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.cargurus.com/search?bodyTypeGroupIds=7&isDeliveryEnabled=false&priceDropsOnly=false&hideNationwideShipping=true&sourceContext=carGurusHomePageModel&page=2&pageAlignment=eyJmaXJzdFBhZ2UiOjE4LCJwYWdlTiI6MjF9"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/cargurus-com-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.cargurus.com/search?bodyTypeGroupIds=7&isDeliveryEnabled=false&priceDropsOnly=false&hideNationwideShipping=true&sourceContext=carGurusHomePageModel&page=2&pageAlignment=eyJmaXJzdFBhZ2UiOjE4LCJwYWdlTiI6MjF9" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/cargurus-com-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/cargurus-com-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cargurus Com Cars Search Scraper", "description": "Scrape CarGurus.com search results and extract 40+ fields per listing — including price, deal rating, seller info, VIN, mileage, and EV data. Perfect for dealers, analysts, and automotive researchers needing structured car inventory data fast.", "version": "0.0", "x-build-id": "AvlaEe2bjgtqhRc6J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~cargurus-com-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-cargurus-com-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~cargurus-com-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-cargurus-com-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~cargurus-com-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-cargurus-com-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 } } } } } } } } } } ```