# Copart Listings Scraper (`piotrv1001/copart-listings-scraper`) Actor The Copart Listings Scraper extracts salvage and insurance vehicle auction lots from Copart US and Canada, capturing live bids, Buy It Now prices, damage and title brand, odometer, specs, photos, and yard location — ideal for dealers, rebuilders, and used car price research. - **URL**: https://apify.com/piotrv1001/copart-listings-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 lots 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ### 🚗 Copart Listings Scraper Extract **salvage and insurance vehicle auction listings from [Copart](https://www.copart.com)** — the largest online salvage car marketplace in North America. The **Copart Listings Scraper** turns the public auction catalog into clean, structured data: live bids, Buy It Now prices, damage type, title brand, odometer, photos and yard location. Copart lists **hundreds of thousands of vehicles at any moment** across the United States and Canada. This scraper lets you sweep the entire catalog or drill into a precise slice — one make, one model year range, one state — and get every field back in JSON, CSV or Excel. Run it on demand, put it on a schedule to track auction prices over time, or call it straight from the [Apify API](https://docs.apify.com/api/v2) and wire it into your own pipeline. ### ✨ Features - 🏷️ **Complete lot records** — year, make, model, trim, VIN, odometer, engine, fuel, drivetrain, transmission, body style, color and keys, all in one row. - 💰 **Live auction data** — current high bid, Buy It Now price, estimated retail value, ACV, sale status and whether the seller's reserve has been met. - 🔧 **Damage and title detail** — primary and secondary damage, title brand and title group, condition code, Run & Drive certification. - 📍 **Yard location** — facility name, city, state, ZIP and exact latitude/longitude for shipping cost calculations. - 🇺🇸 🇨🇦 **United States and Canada** in a single Actor, with prices in the correct local currency. - 🔍 **Precise filtering** — free-text search plus make, model, model year range, state, Buy It Now and Run & Drive filters. - 📸 **Optional full photo galleries** — thumbnail, full and high-resolution URLs for every image on a lot (usually 10–15 per vehicle). - ⚡ **Fast and cheap** — a full sweep of the catalog runs at roughly 15,000 lots per minute. ### 🛠️ How to use the Copart Listings Scraper 1. **Click Try for free** to open the Actor in Apify Console. 2. **Type a search term** — for example `tesla` — or leave it empty and use the filters instead. 3. **Narrow it down (optional)** — pick a make, model, model year range or state, or switch the marketplace to Canada. 4. **Set the maximum number of lots** you want. Start small to see the shape of the data. 5. **Click Start** and watch the results fill the Output tab. Download them as JSON, CSV, Excel or XML, or fetch them over the API. ### 📥 Input Every field is optional — running with the defaults returns 50 Tesla lots from the US marketplace. | Field | Type | Description | | --------------------- | ------------ | ------------------------------------------------------------------------------------------------- | | `searchQuery` | string | Free-text search, exactly like the search box on the site (`tesla`, `f-150 4x4`, `flood damage`). | | `country` | `US` | `CA` | Which marketplace to scrape. Defaults to `US`. | | `make` | string | Vehicle make, e.g. `FORD`, `TOYOTA`, `BMW`. | | `model` | string | Vehicle model, e.g. `F150`, `CAMRY`. Works best together with a make. | | `yearFrom` / `yearTo` | integer | Model year range. | | `state` | string | Two-letter code of the yard location, e.g. `CA`, `TX`, `ON`. | | `buyItNowOnly` | boolean | Only lots that can be bought instantly at a fixed price. | | `runAndDriveOnly` | boolean | Only lots certified as starting and moving under their own power. | | `includeAllPhotos` | boolean | Fetch the full photo gallery for every lot. Off by default. | | `maxItems` | integer | Maximum number of lots to scrape. Defaults to 50. | | `proxyConfiguration` | object | Proxy settings. The defaults work out of the box. | ```json { "searchQuery": "", "country": "US", "make": "FORD", "model": "F150", "yearFrom": 2018, "yearTo": 2024, "state": "TX", "runAndDriveOnly": true, "includeAllPhotos": false, "maxItems": 500 } ``` ### 📊 Output Each lot becomes one dataset item. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. ```json { "lotNumber": "46448946", "url": "https://www.copart.com/lot/46448946/2023-tesla-model-3-ny-long-island", "title": "2023 TESLA MODEL 3", "year": 2023, "make": "TESLA", "model": "MODEL 3", "modelDetail": "MODEL 3", "series": null, "vin": "5YJ3E1EAXPF******", "odometer": 35067, "odometerBrand": "ACTUAL", "engine": null, "cylinders": null, "fuelType": "ELECTRIC", "transmission": "AUTOMATIC", "driveType": "REAR WHEEL DRIVE", "bodyStyle": "SEDAN", "color": "CHARCOAL", "vehicleType": "AUTOMOBILE", "hasKeys": true, "primaryDamage": "REAR END", "secondaryDamage": "SIDE", "conditionCode": "CERT-E", "conditionDescription": "ENHANCED VEHICLES", "runsAndDrives": false, "titleDescription": "MV907A-PARTS ONLY W/LIENHOLDER", "titleGroup": "NON-REPAIRABLE", "titleState": "NY", "currency": "USD", "estimatedRetailValue": 22650, "estimatedCashValue": 24250, "currentBid": 1450, "buyItNowPrice": null, "saleStatus": "Pure Sale", "saleStatusCode": "PURE_SALE", "sellerReserveMet": true, "sold": false, "saleDate": "2026-08-12T14:00:00.000Z", "saleTime": "10:00:00", "saleTimeZone": "EDT", "lastSoldDate": "2026-03-16T07:00:00.000Z", "saleType": null, "location": { "name": "NY - LONG ISLAND", "city": "BROOKHAVEN", "state": "NY", "country": "USA", "zip": "11719 9203", "latitude": 40.77763, "longitude": -72.93093 }, "thumbnailUrl": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/lpp/0326/eb02544c7a154ff581b3c71195d73f8b_thb.jpg" } ``` #### Data fields | Field | Description | | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `lotNumber`, `url` | Copart lot number and the direct link to the listing. | | `title`, `year`, `make`, `model`, `modelDetail`, `series` | Vehicle identity. | | `vin` | Vehicle identification number. Publicly visible characters only — see the FAQ. | | `odometer`, `odometerBrand` | Mileage reading and whether it is `ACTUAL`, `NOT ACTUAL` or exempt. | | `engine`, `cylinders`, `fuelType`, `transmission`, `driveType`, `bodyStyle`, `color`, `vehicleType` | Mechanical specification. | | `hasKeys` | Whether the keys are present with the vehicle. | | `primaryDamage`, `secondaryDamage` | Reported damage, e.g. `FRONT END`, `FLOOD`, `HAIL`. | | `conditionCode`, `conditionDescription`, `runsAndDrives` | Copart condition certification. | | `titleDescription`, `titleGroup`, `titleState` | Title brand — salvage, non-repairable, clean, etc. | | `currency`, `estimatedRetailValue`, `estimatedCashValue` | Valuation, in the marketplace's local currency. | | `currentBid`, `buyItNowPrice`, `saleStatus`, `saleStatusCode`, `sellerReserveMet`, `sold` | Live auction state. | | `saleDate`, `saleTime`, `saleTimeZone`, `lastSoldDate`, `saleType` | Auction schedule and sale history. | | `location` | Yard name, city, state, country, ZIP, latitude and longitude. | | `thumbnailUrl` | Preview image, always included. | | `images` | Full gallery with `thumbnailUrl`, `fullUrl` and `highResUrl` per photo. Only present when `includeAllPhotos` is enabled. | ### 💵 How much does it cost to scrape Copart? The Actor uses **pay per event** pricing, so you pay for the data you get and nothing else — no compute units to reason about. | Event | Price | When it is charged | | ----------------------------------- | ------ | ------------------------------------------------ | | Actor start | $0.005 | Once per run. | | Lot scraped | $0.008 | For each lot returned. | | Lot scraped with full photo gallery | $0.015 | For each lot when `includeAllPhotos` is enabled. | That works out at **$8 per 1,000 lots** — about half the going rate for Copart data on Apify — or **$15 per 1,000 lots** with every photo URL attached. Apify's free plan comes with $5 of monthly usage, enough for roughly 600 lots per month at no cost. Higher subscription plans get an automatic discount on the prices above. ### 💡 Tips - **Leave `includeAllPhotos` off** unless you actually need the galleries. Every lot already ships with a preview image, and the gallery costs nearly twice as much per lot. - **Filter server-side, not afterwards.** Using `make`, `state` or the year range is free — pulling 50,000 lots and filtering them in your own code is not. - **Schedule a daily run** with a tight filter to build a price history for the vehicles you care about. `currentBid`, `sellerReserveMet` and `saleStatus` change as auctions progress. - **Sort by relevance with `searchQuery`.** Leaving it empty browses the catalog by auction date instead, which is what you want for a full sweep. ### ❓ FAQ **Why is part of the VIN hidden?** Copart only shows the full 17-character VIN to logged-in members, so the last six characters come back masked (`5YJ3E1EAXPF******`) everywhere on the public site. The visible 11 characters still decode to the world manufacturer identifier and the full vehicle descriptor — make, model, body, engine, restraint system, model year and assembly plant. Only the production serial number is withheld. **Can I scrape the UK, German or Spanish Copart sites?** Not with this Actor. It covers the United States and Canada. If you need another market, open an issue and we will look into it. **How many lots can I get in one run?** As many as match your filters — there is no depth limit. The full US catalog is well over 400,000 vehicles and a complete sweep takes roughly half an hour. **Do I need my own proxies?** No. The default proxy configuration works out of the box on any Apify plan. **Is scraping Copart legal?** This Actor only collects data that Copart publishes publicly, without logging in and without touching personal information. Web scraping of public data is legal in many jurisdictions, but how you use the data is your responsibility — check your local regulations and Copart's Terms of Service, and consult a lawyer if you are unsure. ### 🙋 Support Found a bug, or need a field that isn't there yet? Open an issue on the **Issues** tab and we will take a look. Custom versions of this scraper — extra filters, different marketplaces, a tailored output shape — are available on request. Start pulling structured salvage auction data with **Copart Listings Scraper** today! 🚀 # Actor input Schema ## `searchQuery` (type: `string`): Free-text search, exactly like the search box on the site (e.g. `tesla`, `f-150 4x4`, `flood damage`). Leave empty to browse the whole catalog and rely on the filters below. ## `country` (type: `string`): Which Copart marketplace to scrape. ## `make` (type: `string`): Filter by vehicle make, e.g. `FORD`, `TOYOTA`, `BMW`. ## `model` (type: `string`): Filter by vehicle model, e.g. `F150`, `CAMRY`. Works best together with a make. ## `yearFrom` (type: `integer`): Only include vehicles from this model year onwards. ## `yearTo` (type: `integer`): Only include vehicles up to this model year. ## `state` (type: `string`): Two-letter code of the yard location, e.g. `CA`, `TX`, `ON`. ## `buyItNowOnly` (type: `boolean`): Only return lots that can be bought instantly at a fixed price. ## `runAndDriveOnly` (type: `boolean`): Only return lots certified as starting and moving under their own power. ## `includeAllPhotos` (type: `boolean`): Fetch the full photo gallery (thumbnail, full and high-resolution URLs) for every lot. Slower and more expensive — one preview image is always included for free. ## `maxItems` (type: `integer`): Maximum number of lots to scrape. ## `proxyConfiguration` (type: `object`): Proxy settings. The defaults are recommended and work out of the box. ## Actor input object example ```json { "searchQuery": "tesla", "country": "US", "buyItNowOnly": false, "runAndDriveOnly": false, "includeAllPhotos": false, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "BUYPROXIES94952" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "searchQuery": "tesla" }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/copart-listings-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 = { "searchQuery": "tesla" } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/copart-listings-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 '{ "searchQuery": "tesla" }' | apify call piotrv1001/copart-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/copart-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/NxIvATLAH6NygBVg6/builds/gdW45R4uaCVuBzww8/openapi.json