# Cargurus Details Spider (`getdataforme/cargurus-details-spider`) Actor Extract comprehensive vehicle details from CarGurus listings, including pricing, specs, features, and dealer info. Perfect for market research, price monitoring, and data analysis. Offers reliable scraping, structured JSON output, scalability, and no API keys needed. - **URL**: https://apify.com/getdataforme/cargurus-details-spider.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** AI, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $9.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. 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 ### Description Extract comprehensive vehicle details from CarGurus listings, including pricing, specs, features, and dealer info. Perfect for market research, price monitoring, and data analysis. Offers reliable scraping, structured JSON output, scalability, and no API keys needed. --- ## Cargurus Details Spider ### Introduction The Cargurus Details Spider is a powerful Apify Actor designed to extract comprehensive vehicle details from CarGurus listings. It scrapes key information such as pricing, specifications, features, and dealer details, enabling users to gather structured data for analysis and decision-making. This tool is ideal for anyone needing reliable, up-to-date car data from one of the largest online car marketplaces. ### Features - **Comprehensive Data Extraction**: Retrieves detailed vehicle specs, pricing, mileage, location, and dealer information from CarGurus pages. - **Structured Output**: Delivers clean, JSON-formatted data that's easy to integrate into databases or analytics tools. - **High Reliability**: Built with robust error handling to ensure consistent performance across various listings. - **Scalable and Fast**: Processes multiple URLs efficiently, supporting batch scraping for large datasets. - **Customizable Inputs**: Accepts a list of URLs for targeted scraping, with validation to ensure valid endpoints. - **Dealer Insights**: Includes dealer ratings, contact info, and inventory links for deeper market analysis. - **No API Keys Required**: Operates directly on public web pages without needing authentication. ### Input Parameters | Parameter | Type | Required | Description | Example | |-----------|------|----------|-------------|---------| | Urls | array | Yes (min 1 item) | A list of CarGurus detail page URLs to scrape. Each URL must be a valid HTTP/HTTPS link pointing to a vehicle listing. | ["https://www.cargurus.com/details/436398375"] | ### Example Usage #### Input ```json { "Urls": [ "https://www.cargurus.com/details/436398375" ] } ```` #### Output ```json [ { "title": "2017 Nissan Rogue", "price": "$6,995", "mileage": "135,982 mi", "location": "Chesapeake, VA", "deal": { "rating": "Great Deal", "price_difference": "$2,076 Below market" }, "vehicle": { "make": "Nissan", "model": "Rogue", "year": "2017", "trim": "S AWD", "condition": "Used", "vin": "JN8AT2MV5HW012493", "stock_number": null }, "specs": { "fuel": { "type": "Gasoline", "tank_size": "14 gal", "mpg": { "combined": "28 MPG", "city": "25 MPG", "highway": "32 MPG" } }, "engine": { "type": "170 hp 2.5L I4", "horsepower": "170 hp", "transmission": "Continuously Variable Transmission", "drivetrain": "All-Wheel Drive" }, "dimensions": { "doors": "4 doors", "front_legroom": "43 in", "rear_legroom": "37 in", "cargo_volume": "32 cu ft" } }, "features": { "safety": [ "ABS Brakes", "Backup Camera", "Curtain Airbags", "Driver Airbag", "Front Side Airbags", "Passenger Airbag" ], "options": [ "Bluetooth", "Steel Wheels" ] }, "dealer": { "name": "CarPro Auto Sales", "phone": "(757) 960-7108", "address": "1122 S Military Hwy, Chesapeake, VA 23320", "status": "Closed", "website": "https://www.cargurus.com/Cars/Link?url=http%3A%2F%2Fwww.carproinc.com%2F%3Futm_source%3Dcargurus.com%26utm_medium%3Dreferral%26utm_campaign%3Dcargurus_listings&hmac=5E8898BDD72029224E63D93B3523A8EF057D646A", "inventory_url": "https://www.cargurus.com/Cars/m-CarPro-Auto-Sales-sp403117", "rating": "4.3", "review_count": null }, "dealer_description": "AWD", "additional_information": "Door Handle Color - Body-Color, Front Bumper Color - Body-Color, Grille Color - Black With Chrome Accents, Mirror Color - Body-Color, Rear Bumper Color - Body-Color, Rear Spoiler Color - Body-Color, Window Trim - Chrome, Rear Spoiler - Roofline, Rear Trunk/Liftgate - Liftgate, Steering Ratio - 17.1, Turns Lock-To-Lock - 3.1, Air Filtration, Floor Material - Cargo Area Carpet, Floor Material - Carpet, Front Air Conditioning, Front Air Conditioning Zones - Single, Shift Knob Trim - Urethane, Steering Wheel Trim - Urethane, Interior Accents - Metallic-Tone, Armrests - Rear Folding, Rear Vents - Second Row, Armrests - Rear Center With Cupholders, Armrests - Rear Center With Pass-Thru, Assist Handle - Front, Assist Handle - Rear, Cargo Cover - Hard, Center Console - Front Console With Armrest And Storage, Cruise Control, Cupholders - Front, Cupholders - Rear, Multi-Function Remote - Keyless Entry, Steering Wheel - Tilt And Telescopic, Steering Wheel Mounted Controls - Audio, Steering Wheel Mounted Controls - Phone, Storage - Cargo Tie-Down Anchors And Hooks, Storage - Door Pockets, Storage - Dual Level Cargo Area, Storage - Front Seatback, Storage - Sunglasses Holder, Power Outlet(S) - 12v Cargo Area, Power Outlet(S) - Two 12v Front, Power Steering - Variable/Speed-Proportional, Vanity Mirrors - Dual, Multi-Function Remote - Panic Alarm, Overhead Console - Front, Storage - In Floor, Steering Wheel Mounted Controls - Cruise Control, Ambient Lighting, Cargo Area Light, Reading Lights - Front, Reading Lights - Rear, Power Windows - Lockout Button, Rearview Mirror - Manual Day/Night, 4wd Type - On Demand, Abs - 4-Wheel, Braking Assist, Cornering Brake Control, Drive Mode Selector, Electronic Brakeforce Distribution, Front Brake Diameter - 11.8, Front Brake Width - 1.04, Front Stabilizer Bar - Diameter 23 Mm, Front Suspension Classification - Independent, Locking Differential - Center, Power Brakes, Rear Brake Diameter - 11.7, Rear Brake Width - 0.64, Rear Stabilizer Bar - Diameter 19 Mm, Rear Suspension Classification - Independent, Rear Suspension Type - Multi-Link, Stability Control, Traction Control, Hill Holder Control, Front Shock Type - Twin-Tube Gas, Front Spring Type - Coil, Front Suspension Type - Lower Control Arms, Rear Shock Type - Twin-Tube Gas, Rear Spring Type - Coil, Front Struts, Front Brake Type - Ventilated Disc, Rear Brake Type - Ventilated Disc, Axle Ratio - 6.39, Off-Road Driving Assist - Hill Descent, Alternator - 110 Amps, Battery Saver, Antenna Type - Diversity, Antenna Type - Mast, Auxiliary Audio Input - Ipod/Iphone, Auxiliary Audio Input - Jack, Auxiliary Audio Input - Usb, Clock, Digital Odometer, External Temperature Display, Fuel Economy Display - Mpg, Fuel Economy Display - Range, In-Dash Cd - Single Disc, Multi-Function Display, Radio - Am/Fm, Radio Data System, Satellite Radio - Siriusxm, Speed Sensitive Volume Control, Trip Odometer, Warnings And Reminders - Low Fuel Level, Electronic Messaging Assistance - With Read Function, Auxiliary Audio Input - Bluetooth, Wireless Data Link - Bluetooth, In-Dash Cd - Mp3 Playback, Total Speakers - 4, Gauge - Tachometer, Infotainment - Nissanconnect, Electronic Messaging Assistance - Voice Operated, Warnings And Reminders - Maintenance Due, Infotainment Screen Size - 5 In., Warnings And Reminders - Coolant Temperature Warning, Warnings And Reminders - Lamp Failure, Warnings And Reminders - Low Oil Pressure, Hands-Free Phone Call Integration - Voice Operated, Daytime Running Lights - Led, Headlights - Auto Delay Off, Headlights - Halogen, Taillights - Led, Tire Pressure Monitoring System, Wheel Covers - Full, Spare Tire Mount Location - Inside, Spare Tire Size - Temporary, Spare Wheel Type - Steel, Tire Type - All Season, Wheels - Steel, Front Wipers - Variable Intermittent, Power Windows, Rear Wiper - Intermittent, Rear Wiper - With Washer, Solar-Tinted Glass, Window Defogger - Rear, Liftgate Window - Fixed, Child Seat Anchors - Latch System, Crumple Zones - Front", "disclaimer": null, "actor_id": "jCfVaerUaYIhseQdU", "run_id": "oDN75lyF3Zdr7qcok" } ] ``` ### Use Cases - **Market Research**: Analyze pricing trends and vehicle availability across regions to inform buying decisions. - **Competitive Intelligence**: Monitor competitors' listings and pricing strategies on CarGurus. - **Price Monitoring**: Track price changes for specific vehicles to identify the best deals. - **Content Aggregation**: Build databases of vehicle details for automotive blogs or comparison sites. - **Academic Research**: Collect data on used car markets for studies in economics or consumer behavior. - **Business Automation**: Integrate with CRM systems to automate lead generation from dealer contacts. ### Installation and Usage 1. Search for "Cargurus Details Spider" in the Apify Store 2. Click "Try for free" or "Run" 3. Configure input parameters 4. Click "Start" to begin extraction 5. Monitor progress in the log 6. Export results in your preferred format (JSON, CSV, Excel) ### Output Format The output is an array of JSON objects, each representing a scraped vehicle listing. Key fields include: - **title**: Vehicle title (e.g., "2017 Nissan Rogue"). - **price**: Listed price. - **mileage**: Vehicle mileage. - **location**: Dealership location. - **deal**: Deal rating and price difference. - **vehicle**: Details like make, model, year, VIN. - **specs**: Fuel, engine, and dimension info. - **features**: Safety and option lists. - **dealer**: Dealer name, contact, rating, and links. - **additional\_information**: Extended specs and features string. - **disclaimer**: Any disclaimers (often null). - **actor\_id** and **run\_id**: Metadata for the scrape. ### Support For custom/simplified outputs or bug reports, please contact: - Email: support@getdataforme.com - Subject line: "custom support" - Contact form: https://getdataforme.com/contact/ We're here to help you get the most out of this Actor! # Actor input Schema ## `Urls` (type: `array`): The urls for the spider. ## Actor input object example ```json { "Urls": [ "https://www.cargurus.com/details/436398375" ] } ``` # Actor output Schema ## `results` (type: `string`): Scraped data items from dataset # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/cargurus-details-spider").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 = {} # Run the Actor and wait for it to finish run = client.actor("getdataforme/cargurus-details-spider").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 '{}' | apify call getdataforme/cargurus-details-spider --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/cargurus-details-spider", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cargurus Details Spider", "description": "Extract comprehensive vehicle details from CarGurus listings, including pricing, specs, features, and dealer info. Perfect for market research, price monitoring, and data analysis. Offers reliable scraping, structured JSON output, scalability, and no API keys needed.", "version": "0.0", "x-build-id": "LuxrmHo5VWHwobDtt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~cargurus-details-spider/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-cargurus-details-spider", "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/getdataforme~cargurus-details-spider/runs": { "post": { "operationId": "runs-sync-getdataforme-cargurus-details-spider", "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/getdataforme~cargurus-details-spider/run-sync": { "post": { "operationId": "run-sync-getdataforme-cargurus-details-spider", "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", "minItems": 1, "type": "array", "description": "The urls for the spider.", "default": [ "https://www.cargurus.com/details/436398375" ], "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```