# IAAI Scraper (`solidcode/iaai-scraper`) Actor \[💰 $2 / 1K] Extract full salvage-vehicle detail from IAAI. Paste vehicle URLs or stock numbers to get VIN, year/make/model, title & damage, odometer, specs, auction date, branch, ACV, current bid, and HD photos — one row per vehicle. - **URL**: https://apify.com/solidcode/iaai-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Other, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 ## IAAI Scraper Pull complete salvage-vehicle records from IAAI (Insurance Auto Auctions) at scale — VIN, year/make/model, primary and secondary damage, title status, odometer, drivetrain specs, actual cash value, auction date, branch location, and high-resolution photos. Paste vehicle detail URLs or bare stock numbers and get one clean, flat row per lot. Built for used-car dealers, exporters, rebuilders, parts resellers, and insurance & valuation analysts who need structured salvage-auction data without opening every IAAI lot page by hand. ### Why This Scraper? - **Full vehicle links or bare numbers, mixed in one run** — paste a full `VehicleDetail` URL, or just the number from that URL (e.g. `41180634`), in any combination; the link is the surest input. - **40+ structured fields per vehicle** — VIN, year, make, model, series, actual cash value, primary and secondary damage, title status, title state, loss type, and more, each as its own column. - **Primary AND secondary damage plus loss type** — three distinct damage signals per lot, not a single lumped field, so you can filter front-end vs. rear-end vs. flood at a glance. - **Up to ~16 HD photo URLs per lot, each with a matching thumbnail** — full-resolution `hdUrl` for inspection, small `thumbUrl` for grids, delivered as ready-to-use links (no downloads). - **Actual cash value, current bid, and Buy Now price as clean numbers** — dollar amounts parsed to numeric (`$2,725 USD` → `2725`) so you can sort and total without string cleanup. - **Flat one-row-per-vehicle schema** — no nested `vehicleInfo` wrapper; every field is top-level and drops straight into Google Sheets, Airtable, or a CRM. - **Branch, selling branch, and full pickup address for every lot** — plan transport and staging with the exact yard, city, state, and lane/run/aisle location. - **Sold or removed lots skip cleanly** — a lot that has already been auctioned is reported and passed over, never crashing a run or billing you for an empty row. - **Normalized, no-noise output** — .NET dates converted to ISO 8601, empty sentinel values dropped, so every row is analysis-ready. ### Use Cases **Dealer Sourcing & Arbitrage** - Build daily watchlists of target makes and models from lot numbers you follow - Compare actual cash value against current bid to spot underpriced lots - Filter by primary/secondary damage to find lightly damaged, resellable units - Track odometer and title status to stay inside your resale criteria **Vehicle Export** - Pull VIN, year/make/model, and drivetrain specs for overseas buyer catalogs - Capture HD photos to share with international clients before bidding - Confirm branch and pickup location to plan container consolidation **Parts & Rebuild Sourcing** - Identify donor vehicles by engine, cylinders, transmission, and drivetrain - Screen for run-and-drive start codes and keys-present status - Match secondary-damage lots to your inventory gaps for cheap parts cars **Insurance & Valuation Research** - Benchmark actual cash value against total-loss settlements - Study damage-to-value ratios across body styles and model years - Track loss types (collision, water/flood, theft) across a portfolio of lots **Market & Price Analysis** - Monitor current bids and sale dates to model salvage-market trends - Aggregate ACV and damage data across makes for pricing dashboards - Feed a spreadsheet of stock numbers in and get a full comparison table out ### Getting Started #### Single Vehicle The simplest run — one stock number: ```json { "vehicles": ["41180634"] } ```` #### Multiple Vehicles, Mixed Input Paste URLs and bare stock numbers together — both work in the same list: ```json { "vehicles": [ "https://www.iaai.com/VehicleDetail/41180634~US", "46034719", "46031179" ] } ``` #### Full Options Cap the run and skip photos for a faster, tabular-only export: ```json { "vehicles": [ "https://www.iaai.com/VehicleDetail/46034719~US", "46034713", "46029523" ], "includeImages": false, "maxResults": 100 } ``` ### Input Reference #### Vehicles | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `vehicles` | string\[] | `["https://www.iaai.com/VehicleDetail/41180634~US"]` | The vehicles to look up — one per line. Paste the full vehicle link (e.g. `https://www.iaai.com/VehicleDetail/41180634~US`), or just the number from that link (e.g. `41180634`). Note: a bare number must be the one in the vehicle's web address, not the "Stock #" printed on the lot page — those can differ, so paste the link when unsure. | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `includeImages` | boolean | `true` | Include full-resolution and thumbnail photo URLs for each vehicle. Turn this off for faster, tabular-only results. | | `maxResults` | integer | `100` | Maximum number of vehicles to return. Set to `0` for no limit (up to 50,000 vehicles per run). Start small to test, then increase. | ### Output Each vehicle produces one flat row. Here is a representative result with photos enabled: ```json { "stockNumber": "45536450", "salvageId": "46034719", "vin": "1C3CCBAB4EN1XXXXX", "year": 2014, "make": "CHRYSLER", "model": "200", "series": "TOURING", "titleStatus": "Salvage Certificate Of Title", "titleState": "Texas", "lossType": "Collision", "primaryDamage": "Front End", "secondaryDamage": "Rear End", "odometer": 129141, "odometerBrand": "Actual", "startCode": "Run & Drive", "keyPresent": true, "engine": "2.4L 4", "cylinders": 4, "transmission": "Automatic", "driveLineType": "Front Wheel Drive", "fuelType": "Gasoline", "bodyStyle": "Sedan 4 Door", "exteriorColor": "White", "interiorColor": "Black", "vehicleType": "Automobile", "airbags": "Intact", "actualCashValue": 2725, "currentBid": 350, "saleDate": "2026-07-10T13:30:00+00:00", "saleTime": "8:30am", "branch": "Dallas", "sellingBranch": "Dallas", "vehicleLocation": "Dallas, TX", "pickupLocation": "204 Skyline Dr, Dallas, TX 75249", "lane": "12", "runNumber": "0042", "aisleStall": "C / 118", "seller": "Insurance Company", "sellerType": "Insurance", "imageCount": 16, "images": [ { "hdUrl": "https://vis.iaai.com/resizer?imageKeys=EXAMPLEKEY&width=2576&height=1932", "thumbUrl": "https://vis.iaai.com/resizer?imageKeys=EXAMPLEKEY&width=161&height=120" } ], "sourceUrl": "https://www.iaai.com/VehicleDetail/46034719~US", "scrapedAt": "2026-07-02T14:30:00Z" } ``` #### Core & Identity | Field | Type | Description | |-------|------|-------------| | `stockNumber` | string | IAAI stock number (human lot identifier) | | `salvageId` | string | IAAI internal salvage ID (the number in the detail URL) | | `vin` | string | Vehicle Identification Number (masked where IAAI masks it) | | `year` | number | Model year | | `make` | string | Manufacturer (e.g. Chrysler) | | `model` | string | Model name | | `series` | string | Trim / series | | `vehicleType` | string | Vehicle class (e.g. Automobile) | | `sourceUrl` | string | The detail URL that produced this row | | `scrapedAt` | string | ISO 8601 timestamp of extraction | #### Vehicle Specs | Field | Type | Description | |-------|------|-------------| | `engine` | string | Engine description | | `cylinders` | number | Cylinder count | | `transmission` | string | Transmission type | | `driveLineType` | string | Drivetrain (FWD/RWD/AWD/4WD) | | `fuelType` | string | Fuel type | | `bodyStyle` | string | Body style | | `exteriorColor` | string | Exterior color | | `interiorColor` | string | Interior color | | `airbags` | string | Airbag status | | `keyPresent` | boolean | Whether keys are present | | `startCode` | string | Start/run condition (e.g. Run & Drive) | #### Title & Damage | Field | Type | Description | |-------|------|-------------| | `titleStatus` | string | Title / document type (e.g. Salvage Certificate of Title) | | `titleState` | string | State that issued the title | | `lossType` | string | Loss category (e.g. Collision, Water/Flood) | | `primaryDamage` | string | Primary damage description | | `secondaryDamage` | string | Secondary damage description | | `odometer` | number | Odometer reading | | `odometerBrand` | string | Odometer status (Actual, Not Actual, Exempt) | #### Valuation | Field | Type | Description | |-------|------|-------------| | `actualCashValue` | number | Estimated actual cash value (ACV) in USD | | `currentBid` | number | Current high bid, when shown | | `buyNowPrice` | number | Buy Now price, when offered | #### Auction & Location | Field | Type | Description | |-------|------|-------------| | `saleDate` | string | Auction / sale date (ISO 8601 where possible) | | `saleTime` | string | Sale start time at the branch (local time, e.g. `8:30am`) | | `branch` | string | IAAI branch handling the vehicle | | `sellingBranch` | string | Selling branch | | `vehicleLocation` | string | Where the vehicle is located | | `pickupLocation` | string | Single-line pickup address | | `lane` | string | Auction lane | | `runNumber` | string | Run number in the lane | | `aisleStall` | string | Aisle / stall (yard location) | | `seller` | string | Seller name | | `sellerType` | string | Seller type (e.g. Insurance) | #### Photos Present only when `includeImages` is on. | Field | Type | Description | |-------|------|-------------| | `imageCount` | number | Number of photos found for the lot | | `images` | object\[] | Photo links, each `{ hdUrl, thumbUrl }` — full-resolution and thumbnail | Null or empty fields are dropped before output, so every row contains only real data. ### Tips for Best Results - **Copy the full vehicle link for the surest results** — a bare number works too, but it has to be the number in the vehicle's web address (URL), which isn't always the same as the "Stock #" shown on the page. When in doubt, paste the link straight from the lot. - **Run soon after a lot is listed** — sold or removed lots drop off IAAI and return no data, so time-sensitive watchlists should be pulled while lots are still live. - **Turn off photos when you only need the table** — set `includeImages` to `false` for faster runs when you're building a spec or pricing sheet and don't need image links. - **Start with a small batch to test** — set `maxResults` to 5-10 on your first run to confirm the fields match your workflow, then scale up. - **Filter on `primaryDamage` and `secondaryDamage` together** — combine the two damage fields to isolate lightly damaged, resellable units from heavy-hit parts cars. - **Compare `actualCashValue` to `currentBid`** — the gap between ACV and the live bid is the fastest signal for spotting underpriced lots in a big batch. - **Paste your whole watchlist at once** — mix URLs and stock numbers in one `vehicles` list and get a single comparison table back. ### Pricing **From $2.00 per 1,000 results** — the lowest tier undercuts comparable IAAI detail extractors. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier. | Results | No discount | Bronze | Silver | Gold | |---------|-------------|--------|--------|------| | 100 | $0.24 | $0.225 | $0.215 | $0.20 | | 1,000 | $2.40 | $2.25 | $2.15 | $2.00 | | 10,000 | $24.00 | $22.50 | $21.50 | $20.00 | | 100,000 | $240.00 | $225.00 | $215.00 | $200.00 | A "result" is one vehicle row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Workflow automation - **Google Sheets** — Direct spreadsheet export - **Slack** / **Email** — Notifications on new results - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access ### Legal & Ethical Use This actor is designed for legitimate vehicle sourcing, export, parts research, and market analysis. You are responsible for complying with applicable laws and IAAI's Terms of Service. Do not use extracted data for spam, harassment, or any illegal purpose, and handle any personal data you collect responsibly. # Actor input Schema ## `vehicles` (type: `array`): The vehicles to look up — one per line. The most reliable input is the full vehicle link copied straight from IAAI (e.g. https://www.iaai.com/VehicleDetail/41180634~US). A bare number also works, but it must be the number that appears in the vehicle's web address (the digits in the URL), not the 'Stock #' shown on the lot page — those can differ, so when in doubt, paste the link. ## `includeImages` (type: `boolean`): Include full-resolution and thumbnail photo URLs for each vehicle. Turn this off for faster, tabular-only results. ## `maxResults` (type: `integer`): Maximum number of vehicles to return. Set to 0 for no limit (up to 50,000 vehicles per run). Tip: start small to test, then increase. ## Actor input object example ```json { "vehicles": [ "https://www.iaai.com/VehicleDetail/41180634~US" ], "includeImages": true, "maxResults": 100 } ``` # Actor output Schema ## `overview` (type: `string`): Table of vehicles with key fields like stock number, VIN, year/make/model, damage, and sale date. ## `details` (type: `string`): Full per-vehicle rows including specs, auction data, valuation, and image URLs. # 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 = { "vehicles": [ "https://www.iaai.com/VehicleDetail/41180634~US" ], "includeImages": true, "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/iaai-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 = { "vehicles": ["https://www.iaai.com/VehicleDetail/41180634~US"], "includeImages": True, "maxResults": 100, } # Run the Actor and wait for it to finish run = client.actor("solidcode/iaai-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 '{ "vehicles": [ "https://www.iaai.com/VehicleDetail/41180634~US" ], "includeImages": true, "maxResults": 100 }' | apify call solidcode/iaai-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/iaai-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "IAAI Scraper", "description": "[💰 $2 / 1K] Extract full salvage-vehicle detail from IAAI. Paste vehicle URLs or stock numbers to get VIN, year/make/model, title & damage, odometer, specs, auction date, branch, ACV, current bid, and HD photos — one row per vehicle.", "version": "1.0", "x-build-id": "JpDjYC45EAPZNd5fM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~iaai-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-iaai-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/solidcode~iaai-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-iaai-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/solidcode~iaai-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-iaai-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": { "vehicles": { "title": "Vehicles", "type": "array", "description": "The vehicles to look up — one per line. The most reliable input is the full vehicle link copied straight from IAAI (e.g. https://www.iaai.com/VehicleDetail/41180634~US). A bare number also works, but it must be the number that appears in the vehicle's web address (the digits in the URL), not the 'Stock #' shown on the lot page — those can differ, so when in doubt, paste the link.", "items": { "type": "string" } }, "includeImages": { "title": "Include Photos", "type": "boolean", "description": "Include full-resolution and thumbnail photo URLs for each vehicle. Turn this off for faster, tabular-only results.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of vehicles to return. Set to 0 for no limit (up to 50,000 vehicles per run). Tip: start small to test, then increase.", "default": 100 } } }, "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 } } } } } } } } } } ```