{
  "openapi": "3.0.1",
  "info": {
    "title": "IAAI Scraper - Salvage Car Auction Lots & Damage Data API",
    "description": "Scrape public IAAI.com salvage auction listings. Damage, odometer with its brand, title type, start code, branch, auction date and ACV for every lot. No API key.",
    "version": "0.1",
    "x-build-id": "tY8vntrhVtTZlb1GR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~iaai-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~iaai-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-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/parseforge~iaai-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-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": {
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Free-text search across the listing, the same box IAAI shows above its results. Combine with the filters below or use it alone.",
            "default": ""
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Vehicle make exactly as IAAI spells it, in capitals — CHEVROLET, TESLA, FORD.",
            "default": ""
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Vehicle model exactly as IAAI spells it, in capitals — SILVERADO 1500, MODEL 3.",
            "default": ""
          },
          "series": {
            "title": "Series",
            "type": "string",
            "description": "Trim or series exactly as IAAI spells it, in capitals — LE, XLT, SPORT.",
            "default": ""
          },
          "yearFrom": {
            "title": "Year from",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Oldest model year to include."
          },
          "yearTo": {
            "title": "Year to",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Newest model year to include."
          },
          "vehicleType": {
            "title": "Vehicle type",
            "enum": [
              "",
              "Automobiles",
              "Boats",
              "Buses",
              "Classics",
              "Equipment",
              "Fleet Vehicles",
              "Heavy Duty Trucks",
              "Light Trucks",
              "Medium Trucks",
              "Motorcycles",
              "Pick-up Trucks",
              "Recreational/ Miscellaneous",
              "Rental Vehicles",
              "SUVs",
              "Trailers",
              "Vans"
            ],
            "type": "string",
            "description": "Restrict to one IAAI inventory type.",
            "default": ""
          },
          "vehicleSubType": {
            "title": "Vehicle subtype",
            "enum": [
              "",
              "ATV",
              "All Terrain",
              "Boat",
              "Competition",
              "Crane",
              "Cruiser",
              "Dirt Bike",
              "Emergency Equipment",
              "Enduro",
              "Farm Equipment",
              "Forestry Equipment",
              "Heavy Equipment",
              "Motor Home",
              "Other",
              "Personal Watercraft",
              "Racer",
              "Road / Street",
              "Scooter",
              "Side By Side",
              "Snowmobile",
              "Sport",
              "Touring",
              "Traditional",
              "Travel Trailer"
            ],
            "type": "string",
            "description": "Narrow inside the vehicle type — Boat, Motor Home, Heavy Equipment, Travel Trailer."
          },
          "bodyStyle": {
            "title": "Body style",
            "enum": [
              "",
              "144 Wb",
              "170 Wb",
              "2-Door",
              "2017.5",
              "2017.5 Sedan",
              "2D Coupe",
              "3 Door Ext Cab Pk",
              "4 Door",
              "4 Door Ext Cab Pk",
              "4 Door Extended Cab Chassis",
              "4 Door Extended Cab Pickup",
              "4-Door",
              "4D Sedan",
              "4Matic",
              "4Matic Sedan",
              "4Motion",
              "5-Door",
              "Access Cab",
              "All Terrain",
              "All4 Sport Utility",
              "All4 Sports Activity Vehicle",
              "Atv",
              "Auto Transporter",
              "Autocycle",
              "Awc",
              "Awd",
              "Awd Sport Utility",
              "Boat",
              "Bus",
              "Bus Non School",
              "Bus School",
              "Cab  Chassis Luv",
              "Cab & Chassis (Luv)",
              "Cab And Chassis",
              "Cab Chassis",
              "Cab Chassis 2 Door",
              "Cab Chassis 4 Door",
              "Cabriolet",
              "Cargo Van",
              "Cargo Van 170 Wb",
              "Cargo Van Lwb",
              "Chassis",
              "Classic",
              "Club Cab",
              "Club Cab Pickup",
              "Commercial Chassis",
              "Compact",
              "Compact Cargo Van",
              "Competition",
              "Concrete/Transit Mix",
              "Contain Chassis",
              "Conventional",
              "Conventional Cab",
              "Convertible",
              "Convertible 2 Door",
              "Coupe",
              "Coupe 2 Door",
              "Coupe 3 Door",
              "Coupe 3 Dr.",
              "Coupe 4 Door",
              "Crew Cab",
              "Crew Cab Long Bed",
              "Crew Cab Swb",
              "Crew Chassis",
              "Crew Pickup",
              "Crew Van",
              "Crewmax",
              "Cruiser",
              "Curtainside",
              "Cutaway",
              "Cutaway 2 Door",
              "Cutaway 3 Door",
              "Dirt Bike",
              "Dolly",
              "Double Cab",
              "Double Cab Long Bed",
              "Double-Cab",
              "Dump",
              "Enduro",
              "Extended Cab",
              "Extended Cab Pickup",
              "Extended Cargo Van",
              "Extended Passenger Van",
              "Extended Sport Van",
              "Extended Van",
              "Extended Wagon",
              "Fastback",
              "Fire Truck",
              "Flatbed",
              "Forward Control",
              "Fronttrak",
              "G",
              "G3500",
              "Glider",
              "Gliders",
              "Grain",
              "Gran Coupe",
              "Hatchback",
              "Hatchback 2 Door",
              "Hatchback 2 Dr.",
              "Hatchback 3 Door",
              "Hatchback 4 Door",
              "Hatchback 4 Dr.",
              "Hatchback 5 Door",
              "Hd",
              "Hd Regular Cab",
              "Hearse",
              "High Roof Cargo Van",
              "High Roof Ext. Cargo Van",
              "High Roof Ext. Van",
              "Hopper",
              "Hybrid",
              "I-Activ Awd Sport Utility",
              "Inc (Strip Chassis)",
              "Inc Pickup 2 Door",
              "Inc(Strip Chass)2Dr",
              "Incomplete (Strip Chassis)",
              "Incomplete Chassis",
              "Incomplete Pickup 4",
              "King Cab",
              "Liftback",
              "Limousine",
              "Limousine 4 Door",
              "Livestock",
              "Low Roof Cargo Van",
              "Low Roof Van",
              "Lowbed",
              "Lwb",
              "Lwb Passenger Van",
              "Lwb Sedan",
              "Medium Duty",
              "Medium Roof Cargo Van",
              "Medium Roof Passenger Wagon",
              "Medium Roof Van",
              "Medium Roof Wagon",
              "Mega Cab",
              "Motor Home",
              "Motor Home 2 Door",
              "Motorcycle",
              "Motorized Home",
              "Multi-Purpose",
              "N/A",
              "Passenger Van",
              "Passenger Wagon Lwb",
              "Pickup",
              "Pickup 2 Door",
              "Pickup 3 Door",
              "Pickup 4 Door",
              "Pillard Hardtop 2 Dr.",
              "Police Interceptor Sedan",
              "Quad Cab",
              "Quad Pickup",
              "Quattro Cabriolet",
              "Quattro Coupe",
              "Quattro Sedan",
              "Quattro Sport Utility",
              "Quattro Spyder",
              "Quattro Wagon",
              "Racer",
              "Regular Cab",
              "Regular Cab Flareside",
              "Regular Cab Styleside",
              "Regular Chassis",
              "Road / Street",
              "Roadster",
              "Rwd",
              "S-Awc",
              "Scooter",
              "Sd Chassis",
              "Sd Crew Cab",
              "Sd Regular Cab",
              "Sd Super Cab",
              "Sedan",
              "Sedan 2 Door",
              "Sedan 2 Dr.",
              "Sedan 2017.5",
              "Sedan 2018.5",
              "Sedan 4 Door",
              "Sedan 4 Dr.",
              "Sedan 5 Door",
              "Sedan 5 Dr.",
              "Sh-Awd",
              "Sh-Awd Sedan",
              "Side By Side",
              "Single Cab",
              "Special",
              "Sport",
              "Sport Ut Truck 4Dr",
              "Sport Utility",
              "Sport Utility Truck",
              "Sport Utility Truck 4 Door",
              "Sport Utility Vehicl",
              "Sport Utility Vehicle 2 Door",
              "Sport Utility Vehicle 4 Door",
              "Sport Van",
              "Sport Wagon",
              "Sports Activity Coupe",
              "Sports Activity Vehicle",
              "Sports Van",
              "Standard Bed Crew Cab",
              "Standard Cab",
              "Station Wagon",
              "Step Van",
              "Step Van 2 Door",
              "Straight Truck",
              "Straight Truck 2 Doo",
              "Straight Truck 2 Door",
              "Straight Truck 2 Dr",
              "Straight Truck 4 Door",
              "Super Cab",
              "Super Cab Flareside",
              "Super Cab Pickup",
              "Super Cab Styleside",
              "Supercab Styleside",
              "Supercrew",
              "Supercrew Cab",
              "Supercrew Cab Styleside",
              "Suv",
              "Suv 2 Door",
              "Suv 4 Door",
              "Swb",
              "Tank",
              "Tilt Cab",
              "Touring",
              "Tractor",
              "Tractor Trk (Diesel)",
              "Tractor Truck",
              "Traditional",
              "Transfer",
              "Truck",
              "Truck Tractor",
              "Unknown",
              "Utility",
              "Van",
              "Van Camper",
              "Van Camper 3 Door",
              "Van Cargo",
              "Van Cargo 3 Door",
              "Van Cargo 4 Door",
              "Van Cargo 5 Door",
              "Van Passenger",
              "Van Passenger 3 Door",
              "Van Passenger 4 Door",
              "Van Passenger 5 Door",
              "Wagon",
              "Wagon 2 Door",
              "Wagon 2 Dr.",
              "Wagon 3 Door",
              "Wagon 4 Door",
              "Wagon 4 Dr.",
              "Wagon 6 Door",
              "Walk In Van Chassis",
              "Xtracab"
            ],
            "type": "string",
            "description": "IAAI's own body style label. 253 values, so it is a picker rather than free text."
          },
          "primaryDamage": {
            "title": "Primary damage",
            "enum": [
              "",
              "All Over",
              "Bio Hazard",
              "Biohazard",
              "Cash For Clunkers",
              "Charity",
              "Electrical",
              "Engine",
              "Engine Burn",
              "Engine Damage",
              "Engine Fire",
              "Exterior Burn",
              "Flood",
              "Frame",
              "Fresh Water",
              "Front",
              "Front & Rear",
              "Front End",
              "Front Window",
              "Hail",
              "Interior Burn",
              "Interior Damage",
              "Interior Fire",
              "Left & Right Side",
              "Left Front",
              "Left Rear",
              "Left Side",
              "Mechanical",
              "None",
              "Normal Wear & Tear",
              "Possible Mech.",
              "Rear",
              "Rear Window",
              "Repossession",
              "Right Front",
              "Right Rear",
              "Right Side",
              "Roll Over",
              "Rollover",
              "Roof",
              "Roof Damage",
              "Salt Water",
              "Steering Column",
              "Storm Damage",
              "Strip",
              "Structural",
              "Suspension",
              "Theft",
              "Total Burn",
              "Transmission Damage",
              "Under Carriage",
              "Undercarriage",
              "Unknown",
              "Vandalized",
              "Water"
            ],
            "type": "string",
            "description": "Restrict to lots with this primary damage.",
            "default": ""
          },
          "lossType": {
            "title": "Loss type",
            "enum": [
              "",
              "Collision",
              "Fire",
              "Other",
              "Theft",
              "Water"
            ],
            "type": "string",
            "description": "Restrict to one loss type.",
            "default": ""
          },
          "airbagState": {
            "title": "Airbags",
            "enum": [
              "",
              "Intact Airbags",
              "Deployed Airbags"
            ],
            "type": "string",
            "description": "Whether the airbags are intact or deployed."
          },
          "startCode": {
            "title": "Start code",
            "enum": [
              "",
              "Can't Test",
              "Run & Drive",
              "Starts",
              "Stationary"
            ],
            "type": "string",
            "description": "Restrict by whether the vehicle runs.",
            "default": ""
          },
          "keyAvailable": {
            "title": "Key",
            "enum": [
              "",
              "Key Available"
            ],
            "type": "string",
            "description": "Only lots where IAAI reports a key."
          },
          "titleType": {
            "title": "Title / sale document",
            "enum": [
              "",
              "Bill Of Sale",
              "Clear",
              "Non-Repairable",
              "None",
              "PartsOnly",
              "Repairable",
              "Salvage"
            ],
            "type": "string",
            "description": "Restrict by the sale document IAAI will issue.",
            "default": ""
          },
          "state": {
            "title": "State or province",
            "enum": [
              "",
              "AB",
              "Alabama",
              "Alaska",
              "Arizona",
              "Arkansas",
              "BC",
              "BC ",
              "California",
              "Colorado",
              "Connecticut",
              "Delaware",
              "Florida",
              "Georgia",
              "Guam",
              "Hawaii",
              "Idaho",
              "Illinois",
              "Indiana",
              "Iowa",
              "Kansas",
              "Kentucky",
              "Louisiana",
              "MB",
              "Maine",
              "Maryland",
              "Massachusetts",
              "Michigan",
              "Minnesota",
              "Mississippi",
              "Missouri",
              "Montana",
              "NB",
              "NL",
              "NS",
              "Nebraska",
              "Nevada",
              "New Hampshire",
              "New Jersey",
              "New Mexico",
              "New York",
              "North Carolina",
              "North Dakota",
              "ON",
              "Ohio",
              "Oklahoma",
              "Oregon",
              "PQ ",
              "Pennsylvania",
              "QC",
              "Rhode Island",
              "SK",
              "South Carolina",
              "South Dakota",
              "Tennessee",
              "Texas",
              "Utah",
              "Vermont",
              "Virginia",
              "Washington",
              "West Virginia",
              "Wisconsin",
              "Wyoming"
            ],
            "type": "string",
            "description": "Restrict to vehicles located in one state or province.",
            "default": ""
          },
          "region": {
            "title": "Region",
            "enum": [
              "",
              "Alaska",
              "East",
              "Hawaii",
              "Midwest",
              "North",
              "Northeast",
              "Northwest",
              "South",
              "Southeast",
              "Southwest",
              "West"
            ],
            "type": "string",
            "description": "IAAI's own sales region, wider than a single state — measured: Southwest returns California lots. It filters on IAAI's grouping, which does not match the `region` value printed on each row; that cell is often blank. Filter by `state` instead if you need a specific one."
          },
          "branch": {
            "title": "Branch",
            "type": "string",
            "description": "Restrict to one IAAI branch, exactly as IAAI names it — for example \"Manchester\".",
            "default": ""
          },
          "market": {
            "title": "Market",
            "enum": [
              "",
              "IAA Canada",
              "IAA United States",
              "Ritchie Bros."
            ],
            "type": "string",
            "description": "IAA United States, IAA Canada or Ritchie Bros."
          },
          "auctionType": {
            "title": "Auction type",
            "enum": [
              "",
              "Buy Now",
              "Live Auctions",
              "Timed Auctions"
            ],
            "type": "string",
            "description": "Restrict by how the lot is sold.",
            "default": ""
          },
          "specialAuction": {
            "title": "Featured auction",
            "enum": [
              "",
              "Gov Auctions",
              "Dream Rides",
              "Electric Vehicle Auctions",
              "Rec Rides",
              "Specialty",
              "Virtual Lane"
            ],
            "type": "string",
            "description": "Government, EV, specialty and other featured auction lanes."
          },
          "buyNowRange": {
            "title": "Buy Now price",
            "enum": [
              "",
              "$0 - $499",
              "$500 - $1,499",
              "$1,500 - $2,999",
              "$3,000 - $4,999",
              "$5,000 and up"
            ],
            "type": "string",
            "description": "Restrict to a Buy Now price band."
          },
          "availability": {
            "title": "Availability",
            "enum": [
              "",
              "Items With a Sale Date",
              "Items Without a Sale Date"
            ],
            "type": "string",
            "description": "Whether the lot already has a sale date."
          },
          "buyerType": {
            "title": "Who can buy",
            "enum": [
              "",
              "Available to the public",
              "Dealer",
              "Dismantler",
              "Exporter",
              "Non-Auto Licensed Business",
              "Other Licensed Business",
              "Rebuilder",
              "Scrapper"
            ],
            "type": "string",
            "description": "Restrict to lots a given buyer type is allowed to bid on. \"Available to the public\" is the one to use if you have no dealer licence.",
            "default": ""
          },
          "transmission": {
            "title": "Transmission",
            "enum": [
              "",
              "Automatic",
              "CVT",
              "Manual",
              "Missing",
              "Unknown"
            ],
            "type": "string",
            "description": "Restrict by transmission.",
            "default": ""
          },
          "driveLineType": {
            "title": "Drivetrain",
            "enum": [
              "",
              "4X2 Drive",
              "All-Wheel Drive",
              "Four Wheel Drive",
              "Front Wheel Drive",
              "Rear Wheel Drive"
            ],
            "type": "string",
            "description": "Restrict by drivetrain.",
            "default": ""
          },
          "fuelType": {
            "title": "Fuel type",
            "enum": [
              "",
              "Diesel",
              "Electric",
              "Flexible",
              "Flexible Fuel",
              "Gasoline",
              "Hybrid",
              "Other"
            ],
            "type": "string",
            "description": "Restrict by fuel type.",
            "default": ""
          },
          "cylinders": {
            "title": "Cylinders",
            "enum": [
              "",
              "1 Cyl",
              "10 Cyl",
              "12 Cyl",
              "2 Cyl",
              "3 Cyl",
              "4 Cyl",
              "5 Cyl",
              "6 Cyl",
              "8 Cyl",
              "All Others",
              "Rotary Engine"
            ],
            "type": "string",
            "description": "Engine cylinder count."
          },
          "engineSize": {
            "title": "Engine size",
            "enum": [
              "",
              "1.0L",
              "1.2 L",
              "1.2L",
              "1.3 L",
              "1.3L",
              "1.4 L",
              "1.4L",
              "1.5 L",
              "1.5L",
              "1.6 L",
              "1.6L",
              "1.7 L",
              "1.7L",
              "1.8",
              "1.8 L",
              "1.8L",
              "1.9 L",
              "1.9L",
              "2 L",
              "2.0L",
              "2.1 L",
              "2.2 L",
              "2.2L",
              "2.3 L",
              "2.3L",
              "2.4 L",
              "2.4L",
              "2.5 L",
              "2.5L",
              "2.6 L",
              "2.7 L",
              "2.7L",
              "2.8 L",
              "2.9 L",
              "2L",
              "3.0L",
              "3.1 L",
              "3.2 L",
              "3.2L",
              "3.3 L",
              "3.3L",
              "3.4 L",
              "3.4L",
              "3.5 L",
              "3.5L",
              "3.6 L",
              "3.6L",
              "3.7 L",
              "3.7L",
              "3.8 L",
              "3.8L",
              "3.9 L",
              "3.9L",
              "4.0L",
              "4.1 L",
              "4.2 L",
              "4.2L",
              "4.3 L",
              "4.3L",
              "4.4 L",
              "4.4L",
              "4.5 L",
              "4.6 L",
              "4.6L",
              "4.7",
              "4.7 L",
              "4.7L",
              "4.8 L",
              "4.8L",
              "5 L",
              "5.0L",
              "5.2 L",
              "5.3 L",
              "5.3L",
              "5.4 L",
              "5.4L",
              "5.5 L",
              "5.5L",
              "5.6 L",
              "5.6L",
              "5.7 L",
              "5.7L",
              "5.8 L",
              "5.9 L",
              "5.9L",
              "5L",
              "6.0L",
              "6.1 L",
              "6.2 L",
              "6.2L",
              "6.3 L",
              "6.4 L",
              "6.4L",
              "6.5 L",
              "6.6 L",
              "6.6L",
              "6.7 L",
              "6.7L",
              "6.8 L",
              "6.8L",
              "7.0L",
              "7.2 L",
              "7.3 L",
              "7.3L",
              "7.4 L",
              "7.5 L",
              "7.8 L",
              "8.0L",
              "8.1 L",
              "8.1L",
              "8.3 L",
              "8.4 L"
            ],
            "type": "string",
            "description": "Displacement in litres, as IAAI writes it."
          },
          "exteriorColor": {
            "title": "Exterior colour",
            "enum": [
              "",
              "- N/A -",
              "- Unknown -",
              "Beige",
              "Black",
              "Blue",
              "Brown",
              "Burgundy",
              "Candy Apple Red",
              "Champagne",
              "Cream",
              "Dark Blue",
              "Dark Brown",
              "Gold",
              "Gray",
              "Green",
              "Grey",
              "Light Blue",
              "Maroon",
              "Navy",
              "Orange",
              "Pewter",
              "Pink",
              "Purple",
              "Red",
              "Silver",
              "Tan",
              "Teal",
              "Turquoise",
              "White",
              "Yellow"
            ],
            "type": "string",
            "description": "Restrict by exterior colour.",
            "default": ""
          },
          "interiorColor": {
            "title": "Interior colour",
            "enum": [
              "",
              "- N/A -",
              "- Unknown -",
              "Beige",
              "Black",
              "Blue",
              "Brown",
              "Burgundy",
              "Candy Apple Red",
              "Champagne",
              "Cream",
              "Dark Blue",
              "Dark Brown",
              "Gold",
              "Gray",
              "Green",
              "Grey",
              "Light Blue",
              "Maroon",
              "Multi",
              "Navy",
              "Orange",
              "Pewter",
              "Pink",
              "Purple",
              "Red",
              "Silver",
              "Tan",
              "Teal",
              "Turquoise",
              "White",
              "Yellow"
            ],
            "type": "string",
            "description": "Restrict by interior colour."
          },
          "countryOfOrigin": {
            "title": "Country of origin",
            "enum": [
              "",
              "Argentina",
              "Australia",
              "Austria",
              "Belgium",
              "Brazil",
              "Canada",
              "China",
              "China, People's Repu",
              "Finland",
              "France",
              "Germany",
              "Hungary",
              "India",
              "Indonesia",
              "Italy",
              "Japan",
              "Korea (South)",
              "Mexico",
              "Portugal",
              "Russian Federation",
              "Slovakia",
              "South Africa",
              "South Korea",
              "Spain",
              "Sweden",
              "Taiwan",
              "Taiwan (Republic Of",
              "Thailand",
              "Turkey",
              "United Kingdom",
              "United States",
              "Unknown",
              "Viet Nam"
            ],
            "type": "string",
            "description": "Where the vehicle was built."
          },
          "auctionWindow": {
            "title": "Auction window",
            "enum": [
              "",
              "AuctionToday",
              "AuctionTomorrow",
              "ThisWeek",
              "NextWeek"
            ],
            "type": "string",
            "description": "Restrict to auctions inside a time window.",
            "default": ""
          },
          "extraFacets": {
            "title": "Extra filters",
            "type": "array",
            "description": "Any IAAI facet not covered above, as {\"group\":\"…\",\"value\":\"…\"} — for example {\"group\":\"AirbagState\",\"value\":\"Intact Airbags\"}. Group names come from IAAI's own filter panel.",
            "default": []
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "IAAI's sort object, for example {\"SortField\":\"AuctionDateTime\",\"IsDescending\":false}. Leave empty for soonest auction first.",
            "default": ""
          },
          "includeDetails": {
            "title": "Include vehicle details",
            "type": "boolean",
            "description": "Fetch each lot's detail page for 43 more fields: IAAI's vehicle grade, the state that issued the title, catalytic converter / battery / radiator presence, bid increment, live pre-bid activity, branch coordinates and the aisle-stall-slot the car is parked in. One extra request per vehicle, billed as a \"vehicle-detail\" event only when the data comes back.",
            "default": false
          },
          "includeMedia": {
            "title": "Include media",
            "type": "boolean",
            "description": "Fetch the full image set at native resolution (measured: 2576x1932), plus the 360 spin, undercarriage and engine-video flags with their URLs. One extra request per vehicle, billed as a \"media\" event only when the data comes back.",
            "default": false
          },
          "decodeVin": {
            "title": "Decode the VIN",
            "type": "boolean",
            "description": "IAAI masks the last six VIN characters for anonymous visitors, but the eleven it publishes are enough for NHTSA's vPIC decoder: trim, engine model, horsepower, GVWR class, assembly plant and manufacturer. One extra request per vehicle, billed as a \"vin-decode\" event only when the decode succeeds.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum vehicles",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Stop after this many vehicles. Free-plan runs return up to 100 as a preview.",
            "default": 100
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "IAAI drops the connection when requests arrive too fast from one IP, and around 400 rows into a paginating search it starts serving empty pages instead of an error. The Actor retries those with a fresh session, which recovers them; if a large job keeps stalling, switch to the RESIDENTIAL group. Measured 19 Aug 2026.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}