# IAAI + Copart Vehicle Auction Scraper (`spry_frame/iaai-copart-vehicle-auction-scraper`) Actor Scrape salvage vehicle listings from IAAI and Copart. Returns VIN, year/make/model, damage type, odometer, ACV, auction date, and 25+ more fields per vehicle. Supports keyword search and direct URL input. Export as JSON, CSV, or Excel. - **URL**: https://apify.com/spry\_frame/iaai-copart-vehicle-auction-scraper.md - **Developed by:** [COSENT GROUP](https://apify.com/spry_frame) (community) - **Categories:** E-commerce, Other - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 vehicle 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 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## IAAI + Copart Vehicle Auction Scraper Scrape salvage vehicle listings from **Insurance Auto Auctions (IAAI)** and **Copart** — the two largest salvage auto auction platforms in the US. Returns 28–32 structured fields per vehicle including VIN, damage type, ACV, auction date, odometer, and more — ready for export as JSON, CSV, or Excel. --- ### What data you get | Field | Example (IAAI) | Example (Copart) | |---|---|---| | `source` | `IAAI` | `Copart` | | `lotNumber` / `stockNumber` | `45728711` | `77830394` | | `vehicleTitle` | `2019 VOLKSWAGEN JETTA 1.4T R-LINE` | `2018 KIA SORENTO LX` | | `year` / `make` / `model` / `series` | `2019 / VOLKSWAGEN / JETTA / 1.4T R-LINE` | `2018 / KIA / SORENTO / LX` | | `vin` | `3VWC57BU1KM******` | `5XYPG4A32JG******` | | `titleDoc` | `Clear` / `Salvage` | `SALVAGE TITLE` / `CERT OF DESTRUCTION` | | `primaryDamage` | `Front End` | `REAR END` | | `secondaryDamage` | `Undercarriage` | `SIDE` | | `odometer` | `116,955 mi` | `82,180 mi` | | `startCode` / `startCode` | `Run & Drive` | `RUNS AND DRIVES` | | `keys` | `Key Available` | `YES` / `NO` | | `engine` | `1.4L I-4 DI, DOHC, VVT, turbo, 147HP` | `2.4L 4` | | `transmission` | `Automatic` | `AUTOMATIC` | | `drivelineType` | `Front Wheel Drive` | `Front-wheel Drive` | | `fuelType` | `Gasoline` | `GAS` | | `cylinders` | `4 Cyl` | `4 Cyl` | | `exteriorColor` | `Silver` | `GRAY` | | `branch` | `Avenel New Jersey` | `FL - TAMPA SOUTH` | | `acv` | `8100` | `11125` | | `highBid` | _(IAAI prebid)_ | `0` | | `auctionDate` | `2026-07-27T08:30:00.000Z` | `2026-07-28T00:00:00.000Z` | | `saleStatus` | `Prebid` / `Live` / `Timed` | `Pure Sale` / `Future Sale` | | `imageUrl` | `https://vis.iaai.com/resizer?...` | `https://cs.copart.com/v1/...` | | `detailUrl` | `https://www.iaai.com/VehicleDetail/...` | `https://www.copart.com/lot/...` | | `scrapedAt` | ISO 8601 timestamp | ISO 8601 timestamp | --- ### How to use You can scrape IAAI, Copart, or both in a single run. Mix and match inputs freely. #### IAAI — paste a search URL from your browser 1. Go to [iaai.com/Search](https://www.iaai.com/Search) 2. Apply your filters (make, model, damage, location, auction date, etc.) 3. Copy the URL from your browser's address bar 4. Paste it into **IAAI Search URLs** ```json { "searchUrls": [ "https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Toyota/", "https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Ford/Models=F-150/" ], "maxItems": 100 } ```` #### Copart — paste a search URL from your browser 1. Go to [copart.com](https://www.copart.com) and run a search 2. Copy the URL from your browser's address bar 3. Paste it into **Copart Search URLs** ```json { "copartSearchUrls": [ "https://www.copart.com/lotSearchResults/?free=true&query=toyota+camry" ], "maxItems": 100 } ``` #### Keyword searches (both platforms) Supply plain-text keywords and the actor builds the search URL for you. ```json { "keywords": ["honda civic", "bmw 3 series"], "copartKeywords": ["ford f-150", "ram 1500"], "maxItems": 200 } ``` #### Scrape both platforms at once ```json { "searchUrls": ["https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Tesla/"], "copartKeywords": ["tesla"], "maxItems": 0 } ``` Set `maxItems` to `0` to scrape all matching results with no cap. *** ### Input schema | Parameter | Type | Description | |---|---|---| | `searchUrls` | `string[]` | IAAI search page URLs | | `keywords` | `string[]` | Keywords to search on IAAI | | `copartSearchUrls` | `string[]` | Copart search page URLs | | `copartKeywords` | `string[]` | Keywords to search on Copart | | `maxItems` | `integer` | Max vehicles total across all sources. `0` = unlimited | | `proxyConfiguration` | `object` | Proxy settings (residential recommended) | *** ### Tips - **Use residential proxies** — IAAI blocks datacenter IPs. The default input already selects Apify residential proxies. Copart's API is more permissive but residential proxies still improve reliability. - **Narrow your search** — IAAI and Copart together can return 500,000+ results. Apply make/model/year/damage/location filters before copying your URL. - **ACV is the key field** — The Actual Cash Value is the insurer's pre-loss estimate. Comparing `acv` to `highBid` is the core deal-scouting workflow. - **`saleStatus: Prebid`** (IAAI) means the vehicle hasn't sold yet — best time to act. - **`highBid: 0`** (Copart) means no bids have been placed yet. *** ### Pricing This actor uses **pay-per-result** pricing — you are charged per vehicle record returned, not by compute time. Typical runs cost a fraction of a cent per vehicle. *** ### Changelog **v1.0** — IAAI scraper: 32 fields per vehicle, full pagination, residential proxy support **v1.1** — Copart scraper added: API-based, 28 fields per vehicle, 100 lots per page, no browser needed # Actor input Schema ## `searchUrls` (type: `array`): Paste one or more IAAI search page URLs directly from your browser — filters already applied. Example: https://www.iaai.com/Search#vehicleSearch/ALL\_LOTS/Makes=Toyota/ ## `keywords` (type: `array`): Vehicle keywords to search for. Each entry produces a separate IAAI keyword search. ## `maxItems` (type: `integer`): Stop after this many vehicles. Set to 0 for unlimited. ## `copartSearchUrls` (type: `array`): Paste one or more Copart search page URLs directly from your browser. Example: https://www.copart.com/lotSearchResults/?free=true\&query=toyota ## `copartKeywords` (type: `array`): Search terms to query on Copart. Each entry produces a separate keyword search. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies recommended for reliability. ## Actor input object example ```json { "searchUrls": [ "https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Toyota/" ], "keywords": [], "maxItems": 0, "copartSearchUrls": [], "copartKeywords": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `source` (type: `string`): Auction platform: IAAI or Copart. ## `inventoryId` (type: `string`): IAAI internal inventory ID (e.g. 46227409~US). ## `stockNumber` (type: `string`): Public lot/stock number shown on the listing. ## `vehicleTitle` (type: `string`): Full vehicle title string, e.g. '2019 VOLKSWAGEN JETTA 1.4T R-LINE'. ## `year` (type: `string`): Model year. ## `make` (type: `string`): Vehicle manufacturer. ## `model` (type: `string`): Vehicle model. ## `series` (type: `string`): Trim level or series designation. ## `vin` (type: `string`): Vehicle Identification Number (partial for non-registered users). ## `titleDoc` (type: `string`): Title type, e.g. Clear, Salvage, Certificate of Destruction. ## `primaryDamage` (type: `string`): Main damage type, e.g. Front End, Rear End, Side, Flood. ## `secondaryDamage` (type: `string`): Secondary damage type if any. ## `loss` (type: `string`): Insurance loss type, e.g. Collision, Theft, Flood. ## `vehicleType` (type: `string`): Category: Automobiles, SUVs, Motorcycles, Heavy Duty Trucks, etc. ## `odometer` (type: `string`): Mileage reading as displayed, e.g. '116,955 mi'. ## `startCode` (type: `string`): Run and drive status: Run & Drive, Starts, Stationary, Can't Test. ## `airbags` (type: `string`): Airbag status: Deployed, Intact, Missing. ## `keys` (type: `string`): Key availability: Key Available, No Key. ## `exteriorColor` (type: `string`): Exterior paint color. ## `engine` (type: `string`): Engine description, e.g. '1.4L I-4 DI, DOHC, VVT, turbo, 147HP'. ## `fuelType` (type: `string`): Fuel type: Gasoline, Diesel, Electric, Hybrid, etc. ## `cylinders` (type: `string`): Engine cylinder count, e.g. '4 Cyl', '6 Cyl'. ## `transmission` (type: `string`): Transmission type: Automatic or Manual. ## `drivelineType` (type: `string`): Drivetrain: Front Wheel Drive, All Wheel Drive, 4WD, etc. ## `bodyStyle` (type: `string`): Body style: Sedan, SUV, Pickup, Coupe, etc. ## `branch` (type: `string`): IAAI branch/yard name and state. ## `laneRun` (type: `string`): Physical lane and run number at the auction yard. ## `market` (type: `string`): Auction market: IAA United States, IAA Canada, Ritchie Bros. ## `acv` (type: `string`): Actual Cash Value — insurer's estimated pre-loss vehicle value. ## `auctionDate` (type: `string`): Scheduled auction date and time. ## `saleStatus` (type: `string`): Current sale status: Prebid, Live, Timed, BuyNow, Sold. ## `imageUrl` (type: `string`): Primary vehicle photo URL. ## `detailUrl` (type: `string`): Direct link to the full vehicle detail page on IAAI. ## `scrapedAt` (type: `string`): ISO 8601 timestamp of when this record was scraped. # 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 = { "searchUrls": [ "https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Toyota/" ], "keywords": [], "copartSearchUrls": [], "copartKeywords": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("spry_frame/iaai-copart-vehicle-auction-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 = { "searchUrls": ["https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Toyota/"], "keywords": [], "copartSearchUrls": [], "copartKeywords": [], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("spry_frame/iaai-copart-vehicle-auction-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 '{ "searchUrls": [ "https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Toyota/" ], "keywords": [], "copartSearchUrls": [], "copartKeywords": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call spry_frame/iaai-copart-vehicle-auction-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=spry_frame/iaai-copart-vehicle-auction-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "IAAI + Copart Vehicle Auction Scraper", "description": "Scrape salvage vehicle listings from IAAI and Copart. Returns VIN, year/make/model, damage type, odometer, ACV, auction date, and 25+ more fields per vehicle. Supports keyword search and direct URL input. Export as JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "ftxuQeUNESuxTtWmV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spry_frame~iaai-copart-vehicle-auction-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spry_frame-iaai-copart-vehicle-auction-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/spry_frame~iaai-copart-vehicle-auction-scraper/runs": { "post": { "operationId": "runs-sync-spry_frame-iaai-copart-vehicle-auction-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/spry_frame~iaai-copart-vehicle-auction-scraper/run-sync": { "post": { "operationId": "run-sync-spry_frame-iaai-copart-vehicle-auction-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": { "searchUrls": { "title": "IAAI Search URLs", "type": "array", "description": "Paste one or more IAAI search page URLs directly from your browser — filters already applied. Example: https://www.iaai.com/Search#vehicleSearch/ALL_LOTS/Makes=Toyota/" }, "keywords": { "title": "Keyword Searches", "type": "array", "description": "Vehicle keywords to search for. Each entry produces a separate IAAI keyword search." }, "maxItems": { "title": "Max Vehicles", "minimum": 0, "type": "integer", "description": "Stop after this many vehicles. Set to 0 for unlimited.", "default": 0 }, "copartSearchUrls": { "title": "Copart Search URLs", "type": "array", "description": "Paste one or more Copart search page URLs directly from your browser. Example: https://www.copart.com/lotSearchResults/?free=true&query=toyota" }, "copartKeywords": { "title": "Copart Keyword Searches", "type": "array", "description": "Search terms to query on Copart. Each entry produces a separate keyword search." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for reliability." } } }, "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 } } } } } } } } } } ```