# IAAI Vehicle Scraper - Salvage Auction Data (`benthepythondev/iaai-vehicle-scraper`) Actor Scrape IAAI search results and vehicle details with VIN, damage, odometer, title, auction, branch, bids, specifications and high-resolution images. - **URL**: https://apify.com/benthepythondev/iaai-vehicle-scraper.md - **Developed by:** [Ben](https://apify.com/benthepythondev) (community) - **Categories:** E-commerce, Automation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.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 ## IAAI Vehicle Scraper - Salvage Auction Data Scrape public vehicle listings from **IAA (IAAI / Insurance Auto Auctions)** into structured records for market research, inventory monitoring, vehicle sourcing, valuation workflows, and auction analysis. The Actor accepts IAAI search-result pages, individual vehicle-detail URLs, or simple search keywords. It can return fast search-card data or enrich every selected lot with specifications, damage, title information, branch details, auction timing, public bid fields, and high-resolution image URLs. The output is saved to the default Apify dataset and can be downloaded as JSON, CSV, Excel, XML, or RSS. You can also run the Actor through the Apify API, schedule it, connect a webhook, or use the resulting dataset in Make, Zapier, n8n, Python, a database, or a business-intelligence tool. ### What can the IAAI Vehicle Scraper collect? Each vehicle can include: - IAAI salvage ID and stock number - Year, make, model, series, and listing title - Public masked VIN and VIN status - Inventory type, status, and category - Primary and secondary damage - Loss type and title or sale document - Title state and buyer eligibility codes - Odometer value, unit, brand, and display text - Run-and-drive, operability, key, and airbag indicators - Engine, fuel, cylinders, transmission, and drivetrain - Body style, vehicle class, colors, and country of origin - Selling branch, address, city, state, ZIP code, and phone - Public latitude and longitude when supplied by IAAI - Auction date and time, lane, run number, aisle, and stall - Public current-bid or buy-now values when displayed - Actual cash value and estimated repair cost when displayed - Seller label, currency, public-auction flag, and vehicle grade - Main image, full public image list, and image count - Original IAAI vehicle URL, search query, rank, and scrape timestamp Fields are source-dependent. IAAI may mask a VIN, seller, bid, repair estimate, or other value for anonymous visitors. The Actor returns the public value that was present during the run and does not invent missing information. ### Why use this Actor? IAA's search pages contain useful vehicle summaries, while each vehicle page contains a much richer structured model. Manually opening lots, copying fields, and downloading links is slow and difficult to repeat. This Actor turns the public pages into consistent rows that are easier to filter, compare, monitor, and join with internal data. Common workflows include: - Salvage and used-vehicle inventory research - Auction sourcing for dealers, rebuilders, dismantlers, and exporters - Damage, mileage, title, and location comparisons - Branch-level inventory monitoring - Vehicle-image collection for a reviewed shortlist - Historical auction snapshots and price research - VIN-based reconciliation with internal inventory - Input data for repair-cost or resale-value models - Alerts when matching public lots appear ### Input #### Search or vehicle URLs Paste one or more public IAAI URLs in `startUrls`. Search pages discover lots. Vehicle-detail pages extract one exact lot. ```json { "startUrls": [ {"url": "https://www.iaai.com/Search?keyword=toyota"} ], "includeDetails": true, "maxResults": 10 } ```` You can use the filters on IAAI first and paste the resulting search URL. The Actor preserves that URL as the search source, reads the visible result set, deduplicates vehicle links, and stops at `maxResults`. #### Keywords Use `keywords` to add simple searches without constructing a URL: ```json { "startUrls": [], "keywords": ["toyota", "tesla", "ford f-150"], "includeDetails": true, "maxResults": 20 } ``` Search terms can be a make, model, VIN fragment, stock number, or another phrase accepted by IAAI's public search. #### Detail-only extraction For a known lot, supply its detail URL: ```json { "startUrls": [ {"url": "https://www.iaai.com/VehicleDetail/46100528~US"} ], "maxResults": 1 } ``` Direct detail URLs are always parsed as detail pages. `includeDetails` controls whether lots discovered from search pages are also opened for enrichment. #### Fast search mode Set `includeDetails` to `false` when you only need the visible search-card fields and want fewer requests: ```json { "startUrls": [ {"url": "https://www.iaai.com/Search?keyword=honda"} ], "includeDetails": false, "maxResults": 50 } ``` Search mode still returns vehicle identity, title, stock number, masked VIN, damage, odometer, branch, auction time, image, and source URL when those fields appear in the card. ### Example output The exact values change as IAAI inventory changes. A normalized vehicle row has this shape: ```json { "source": "iaai", "salvage_id": "46100528", "stock_number": "45602105", "title": "2009 TOYOTA SIENNA LE", "year": 2009, "make": "TOYOTA", "model": "SIENNA", "series": "LE", "vin_mask": "5TDZK23C19S******", "primary_damage": "Normal Wear & Tear", "odometer": 143828, "odometer_unit": "mi", "run_and_drive": true, "key_available": true, "engine": "3.5L V-6 DOHC, VVT, 266HP", "transmission": "Automatic Transmission", "branch_name": "Clearwater (FL)", "currency": "USD", "image_count": 10, "url": "https://www.iaai.com/VehicleDetail/46100528~US", "scraped_at": "2026-07-11T09:00:00+00:00" } ``` `source_attributes` preserves additional public fields from IAAI's embedded vehicle model. This is useful when you need a less common source field that is not part of the main normalized columns. ### Search discovery and detail enrichment The Actor deliberately separates discovery from enrichment. A search request can expose many candidate lots. Detail requests are then limited to the unique vehicles inside `maxResults`. This keeps scheduled runs bounded and avoids spending time on records you did not request. For repeat monitoring, start with a narrow IAAI search and a small result limit. Save the `salvage_id` or `stock_number` as your stable key. Append snapshots with `scraped_at` instead of overwriting prior data. That allows you to detect new lots, changed public auction dates, or newly displayed prices without treating every run as a new vehicle. ### Pricing This Actor uses transparent pay-per-event pricing: - **$0.00005** when the Actor starts - **$0.003** for each vehicle saved to the default dataset A successful 10-vehicle run costs about **$0.03005** in Actor charges before ordinary Apify platform usage. Failed or invalid URLs that do not produce a dataset row are not billed as result events. Use `maxResults` to keep the output and charge bounded. ### Reliability and data quality The implementation reads IAAI's server-rendered public search cards and the structured vehicle model embedded in public detail pages. It does not require a logged-in IAAI account, a browser runtime, or a paid unblocker. Requests use bounded retries, Chrome-compatible HTTP behavior, explicit timeouts, URL validation, deduplication, and a five-request detail concurrency limit. The run fails explicitly when no useful vehicle rows are produced. That makes a broken extractor visible to schedules and monitoring instead of silently returning an empty successful dataset. Source data can still change. Auction values are point-in-time observations, public fields may be masked, and lots can be sold or removed. Confirm material purchasing, title, damage, fee, eligibility, and pickup decisions directly with IAAI and qualified professionals. ### Automation examples You can schedule a narrow search every morning, compare the returned IDs with yesterday's dataset, and send only new lots to a review channel. A dealer can route selected rows into a CRM. A parts business can filter by make, model, damage, and branch. An analyst can store daily public snapshots in a warehouse and compare auction supply by region. For webhooks, use the Actor run success event and retrieve the default dataset through its API URL. For larger workflows, keep collection and business rules separate: let the Actor collect source records, then apply your valuation, qualification, or alert thresholds downstream. ### Responsible use Use the Actor for legitimate public-data research and follow IAAI's terms, applicable law, intellectual-property rights, and your organization's compliance requirements. Do not use it to bypass access controls, submit bids, impersonate buyers, or make automated purchasing decisions without human review. A public listing is not a warranty. A masked VIN is not a complete identifier. “Run & Drive,” title labels, damage descriptions, odometer brands, estimates, bids, and images must be assessed in context. Obtain inspections, reports, fee schedules, licensing guidance, and title advice where appropriate. ### FAQ #### Does the Actor require an IAAI login? No. It extracts fields available on public IAAI search and vehicle pages. Account-only values remain unavailable. #### Can I paste a filtered IAAI search URL? Yes. Apply filters on IAAI and add the resulting public search URL to `startUrls`. #### Can I scrape one known vehicle? Yes. Supply its `/VehicleDetail/...` URL and set `maxResults` to `1`. #### Why is a VIN or seller masked? IAAI controls what anonymous visitors can see. The Actor returns the public source value and does not attempt to unmask it. #### Why is a bid or buy-now price empty? Some auctions do not expose those values publicly, have not opened, or use a sale format without that field. Missing is different from zero, so the output keeps unavailable values as `null`. #### Does this Actor place bids or buy vehicles? No. It is a read-only data extraction tool. #### How do I report a problem? Open an issue on the Actor page with a public example URL, the run ID, the field you expected, and what you received. Do not include account credentials or private buyer information. If the Actor saves you time, please leave a Store review. Reviews help prioritize maintenance and make reliable tools easier for other users to find. ### You might also like - [Cars.com Scraper](https://apify.com/benthepythondev/cars-com-scraper) for dealer vehicle listings and prices - [Kleinanzeigen Autos Scraper](https://apify.com/benthepythondev/kleinanzeigen-autos-scraper) for German classified vehicle listings - [Vehicle Recalls Intelligence](https://apify.com/benthepythondev/vehicle-recalls-intelligence) for public recall and safety research ### Keywords IAAI scraper, IAA scraper, Insurance Auto Auctions scraper, salvage vehicle scraper, auto auction data, vehicle auction scraper, damaged car data, VIN auction data, salvage inventory, IAAI vehicle details, auction image scraper, vehicle sourcing, dealer inventory research, car auction API, Apify IAAI scraper # Actor input Schema ## `startUrls` (type: `array`): Public IAAI search-result or VehicleDetail URLs. Search URLs discover lots; detail URLs extract one exact vehicle. ## `keywords` (type: `array`): Optional IAAI search terms such as a make, model, VIN fragment, or stock number. ## `includeDetails` (type: `boolean`): Open each discovered vehicle page to add specifications, damage, sale information, branch details, bids, and all public image URLs. ## `maxResults` (type: `integer`): Maximum number of unique vehicle records saved across all supplied searches and detail URLs. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.iaai.com/Search?keyword=toyota" } ], "keywords": [ "toyota" ], "includeDetails": true, "maxResults": 10 } ``` # 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 = { "startUrls": [ { "url": "https://www.iaai.com/Search?keyword=toyota" } ], "keywords": [ "toyota" ], "includeDetails": true, "maxResults": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("benthepythondev/iaai-vehicle-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 = { "startUrls": [{ "url": "https://www.iaai.com/Search?keyword=toyota" }], "keywords": ["toyota"], "includeDetails": True, "maxResults": 10, } # Run the Actor and wait for it to finish run = client.actor("benthepythondev/iaai-vehicle-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 '{ "startUrls": [ { "url": "https://www.iaai.com/Search?keyword=toyota" } ], "keywords": [ "toyota" ], "includeDetails": true, "maxResults": 10 }' | apify call benthepythondev/iaai-vehicle-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=benthepythondev/iaai-vehicle-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "IAAI Vehicle Scraper - Salvage Auction Data", "description": "Scrape IAAI search results and vehicle details with VIN, damage, odometer, title, auction, branch, bids, specifications and high-resolution images.", "version": "1.0", "x-build-id": "SFwXrBq2tyXR8AarK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~iaai-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-iaai-vehicle-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/benthepythondev~iaai-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-iaai-vehicle-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/benthepythondev~iaai-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-iaai-vehicle-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": { "startUrls": { "title": "IAAI search or vehicle URLs", "type": "array", "description": "Public IAAI search-result or VehicleDetail URLs. Search URLs discover lots; detail URLs extract one exact vehicle.", "default": [ { "url": "https://www.iaai.com/Search?keyword=toyota" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Additional search keywords", "type": "array", "description": "Optional IAAI search terms such as a make, model, VIN fragment, or stock number.", "default": [], "items": { "type": "string" } }, "includeDetails": { "title": "Fetch full vehicle details", "type": "boolean", "description": "Open each discovered vehicle page to add specifications, damage, sale information, branch details, bids, and all public image URLs.", "default": true }, "maxResults": { "title": "Maximum vehicles", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of unique vehicle records saved across all supplied searches and detail URLs.", "default": 10 } } }, "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 } } } } } } } } } } ```