{
  "openapi": "3.0.1",
  "info": {
    "title": "Copart Scraper: Salvage & Used Car Auctions, VIN, Bids & ACV",
    "description": "Copart scraper for salvage and used car auctions: every lot by make, model, year, damage, title, yard or sale date, with current bid, buy-it-now price, retail value (ACV), odometer, VIN, keys and auction date. US, Canada, UK, Ireland, Germany, Spain, Finland. Daily new-lots feed.",
    "version": "0.1",
    "x-build-id": "zn0YQm3BYd0yxSYFB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automatic~copart-auction-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automatic-copart-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/automatic~copart-auction-scraper/runs": {
      "post": {
        "operationId": "runs-sync-automatic-copart-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/automatic~copart-auction-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-automatic-copart-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": {
          "country": {
            "title": "Copart site",
            "enum": [
              "us",
              "ca",
              "uk",
              "ie",
              "de",
              "es",
              "fi"
            ],
            "type": "string",
            "description": "Which Copart site to search. copart.com also lists the Canadian yards. Every filter below works on the US and Canada sites; the UK and Ireland sites take make, model, year, mileage, damage, yard, sale date, buy-it-now and run-and-drive (the UK site also vehicle type: automobiles, motorcycles, RVs and farm equipment); Germany, Spain and Finland take make, year, mileage, damage, yard and sale date (Germany and Spain also buy-it-now). A pasted search link always uses its own site.",
            "default": "us"
          },
          "makes": {
            "title": "Makes",
            "type": "array",
            "description": "Makes as Copart writes them, e.g. TOYOTA, FORD, MERCEDES-BENZ (any letter case). Several makes return lots of any of them. A misspelled make returns no lots and the run says so.",
            "items": {
              "type": "string"
            }
          },
          "models": {
            "title": "Models",
            "type": "array",
            "description": "Model names, e.g. CAMRY, F150, CIVIC (Copart's model group, so CAMRY includes every Camry trim). Best used with a make.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Keyword searches",
            "type": "array",
            "description": "Optional free-text searches, one per line, as typed in Copart's search box (e.g. 'cybertruck', 'f-250', a VIN). Like Copart's search box, several words match lots with any of them, so use Makes and Models for an exact model. Each runs as its own search with the filters on this form; leave empty to search with the filters alone.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Copart search links",
            "type": "array",
            "description": "Optional: paste up to 10 Copart results-page links (copart.com/lotSearchResults?...; also copart.ca, copart.co.uk, copart.ie, copart.de, copart.es, copart.fi). Each link keeps every filter you set on Copart, including 'Search near ZIP code'. The filters on this form are not added to pasted links.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "yearMin": {
            "title": "Year from",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Oldest model year."
          },
          "yearMax": {
            "title": "Year to",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Newest model year."
          },
          "odometerMin": {
            "title": "Odometer from",
            "minimum": 0,
            "maximum": 9999999,
            "type": "integer",
            "description": "Lowest odometer reading, in the lot's own unit (miles for US and UK yards, km for Canadian yards, also on copart.com, and elsewhere)."
          },
          "odometerMax": {
            "title": "Odometer to",
            "minimum": 0,
            "maximum": 9999999,
            "type": "integer",
            "description": "Highest odometer reading, in the lot's own unit."
          },
          "damageTypes": {
            "title": "Primary damage",
            "type": "array",
            "description": "Only lots whose primary damage is one of these.",
            "items": {
              "type": "string",
              "enum": [
                "frontend",
                "rearend",
                "side",
                "allover",
                "minordentscratches",
                "mechanical",
                "waterflood",
                "haildamage",
                "rollover",
                "toproof",
                "undercarriage",
                "vandalism",
                "normalwear",
                "burn",
                "burnengine",
                "burninterior",
                "framedamage",
                "stripped",
                "biohazardchemical",
                "damagehistory",
                "missingalteredvin",
                "partialrepair",
                "rejectedrepair",
                "replacedvin",
                "unknown"
              ],
              "enumTitles": [
                "Front End",
                "Rear End",
                "Side",
                "All Over",
                "Minor Dent/Scratches",
                "Mechanical",
                "Water/Flood",
                "Hail",
                "Rollover",
                "Top/Roof",
                "Undercarriage",
                "Vandalism",
                "Normal Wear",
                "Burn",
                "Burn - Engine",
                "Burn - Interior",
                "Frame Damage",
                "Stripped",
                "Biohazard/Chemical",
                "Damage History",
                "Missing/Altered VIN",
                "Partial Repair",
                "Rejected Repair",
                "Replaced VIN",
                "Unknown"
              ]
            }
          },
          "titleTypes": {
            "title": "Title type",
            "type": "array",
            "description": "Clean, salvage or non-repairable title (US and Canada sites).",
            "items": {
              "type": "string",
              "enum": [
                "cleantitle",
                "salvagetitle",
                "nonrepairable"
              ],
              "enumTitles": [
                "Clean title",
                "Salvage title",
                "Non-repairable"
              ]
            }
          },
          "vehicleTypes": {
            "title": "Vehicle type",
            "type": "array",
            "description": "Cars, SUVs, pickups, motorcycles, boats, RVs, trucks, equipment and more (US and Canada sites; on the UK site automobiles, motorcycles, RVs and farm equipment).",
            "items": {
              "type": "string",
              "enum": [
                "automobiles",
                "suvs",
                "pickuptrucks",
                "motorcycle",
                "atvs",
                "dirtbikes",
                "snowmobile",
                "jetskis",
                "boats",
                "recreationalveh",
                "trailers",
                "mediumdutyboxtrucks",
                "heavydutytrucks",
                "bus",
                "constructionequipment",
                "industrialequipment",
                "agricultureandfarmequipment"
              ],
              "enumTitles": [
                "Automobiles",
                "SUVs",
                "Pickup trucks",
                "Motorcycles",
                "ATVs",
                "Dirt bikes",
                "Snowmobiles",
                "Jet skis",
                "Boats",
                "RVs",
                "Trailers",
                "Medium-duty box trucks",
                "Heavy-duty trucks",
                "Buses",
                "Construction equipment",
                "Industrial equipment",
                "Farm equipment"
              ]
            }
          },
          "fuelTypes": {
            "title": "Fuel",
            "type": "array",
            "description": "Gas, diesel, electric, hybrid or flex fuel (US and Canada sites).",
            "items": {
              "type": "string",
              "enum": [
                "gas",
                "diesel",
                "electric",
                "hybrid",
                "flexible"
              ],
              "enumTitles": [
                "Gas",
                "Diesel",
                "Electric",
                "Hybrid",
                "Flex fuel"
              ]
            }
          },
          "runAndDriveOnly": {
            "title": "Run and drive only",
            "type": "boolean",
            "description": "Only lots Copart marks Run and Drive."
          },
          "buyItNowOnly": {
            "title": "Buy it now only",
            "type": "boolean",
            "description": "Only lots with a buy-it-now price."
          },
          "states": {
            "title": "States or provinces",
            "type": "array",
            "description": "Two-letter codes of the yard's state or province, e.g. TX, FL, ON (US and Canada sites).",
            "items": {
              "type": "string"
            }
          },
          "yards": {
            "title": "Yards",
            "type": "array",
            "description": "Yard names exactly as Copart shows them, e.g. 'TX - DALLAS', 'CA - LOS ANGELES', 'BRISTOL', 'Frankfurt'.",
            "items": {
              "type": "string"
            }
          },
          "zipCode": {
            "title": "ZIP code",
            "type": "string",
            "description": "Only lots at yards within the radius of this US ZIP code, e.g. 75201 or 02134 (5 digits; US and Canada sites). The map point comes from the US Census Bureau's ZIP table bundled with this Actor; a ZIP it has no point for is skipped and named in the run summary."
          },
          "nearLatitude": {
            "title": "Near latitude",
            "type": "string",
            "description": "With Near longitude: only lots at yards within Radius of this point (US and Canada sites), e.g. 32.7767. For a US ZIP code use ZIP code above instead; for a search Copart builds on its site, paste the link."
          },
          "nearLongitude": {
            "title": "Near longitude",
            "type": "string",
            "description": "E.g. -96.7970."
          },
          "radiusMiles": {
            "title": "Radius (miles)",
            "minimum": 25,
            "maximum": 200,
            "type": "integer",
            "description": "Distance from the ZIP code or map point above: 25, 50, 75, 100, 125, 150, 175 or 200 miles. Default 50."
          },
          "auctionWithinDays": {
            "title": "Auction within the next N days",
            "minimum": 1,
            "maximum": 60,
            "type": "integer",
            "description": "Only lots whose auction is scheduled in the next N days."
          },
          "saleDateFrom": {
            "title": "Auction date from",
            "type": "string",
            "description": "Only lots auctioned on or after this date (UTC). Use this or 'Auction within', not both."
          },
          "saleDateTo": {
            "title": "Auction date to",
            "type": "string",
            "description": "Only lots auctioned on or before this date (UTC)."
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "upcoming",
              "auctionDate",
              "newest"
            ],
            "type": "string",
            "description": "Leave empty for the usual choice: an empty input or a search with an auction-date window shows upcoming auctions, soonest first; other searches keep Copart's own order so every lot is included; monitors look at the newest lots first. A choice made here is always used as given."
          },
          "maxResults": {
            "title": "Maximum lots",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Most lots to deliver per run, shared fairly across your searches (up to 50,000). With monitoring on, this is how many lots are checked each run. About 2 s per 100 lots.",
            "default": 100
          },
          "monitorMode": {
            "title": "Monitor",
            "enum": [
              "off",
              "new",
              "changes"
            ],
            "type": "string",
            "description": "For scheduled runs. The first run returns every lot and remembers them; later runs return only new lots, or new and changed ones, marked with what changed. Unchanged lots are not charged.",
            "default": "off"
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional name that keeps the monitor's memory when you edit its filters. Without it, each distinct set of searches and filters has its own memory."
          },
          "source": {
            "title": "Auction",
            "enum": [
              "copart"
            ],
            "type": "string",
            "description": "The auction to search. Copart today."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}