{
  "openapi": "3.0.1",
  "info": {
    "title": "Copart Public Search Scraper",
    "description": "Extract vehicle auction data from Copart's public search. Search by keyword, make, model, year range, damage type, and location. Returns lot details including VIN, mileage, damage, current bid, auction date, and more.",
    "version": "0.1",
    "x-build-id": "ZLFdYik6ITNVCXGR8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jungle_synthesizer~copart-public-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jungle_synthesizer-copart-public-search-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/jungle_synthesizer~copart-public-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-jungle_synthesizer-copart-public-search-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/jungle_synthesizer~copart-public-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-jungle_synthesizer-copart-public-search-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",
        "required": [
          "maxItems"
        ],
        "properties": {
          "sp_intended_usage": {
            "title": "What is the intended usage of this data?",
            "minLength": 1,
            "type": "string",
            "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking."
          },
          "sp_improvement_suggestions": {
            "title": "How can we improve this crawler for you?",
            "minLength": 1,
            "type": "string",
            "description": "Provide any feedback or suggestions for improvements."
          },
          "sp_contact": {
            "title": "Contact email (optional)",
            "minLength": 1,
            "type": "string",
            "description": "We'll personally help with your use case. No spam."
          },
          "searchQuery": {
            "title": "Search Query",
            "type": "string",
            "description": "Keyword to search for (e.g. \"toyota camry\", \"honda\", \"salvage\")"
          },
          "make": {
            "title": "Make Filter",
            "type": "string",
            "description": "Filter by vehicle make (e.g. \"TOYOTA\", \"HONDA\", \"FORD\")"
          },
          "model": {
            "title": "Model Filter",
            "type": "string",
            "description": "Filter by vehicle model (e.g. \"CAMRY\", \"CIVIC\")"
          },
          "yearFrom": {
            "title": "Year From",
            "type": "integer",
            "description": "Filter by minimum year (e.g. 2015)"
          },
          "yearTo": {
            "title": "Year To",
            "type": "integer",
            "description": "Filter by maximum year (e.g. 2023)"
          },
          "damageFilter": {
            "title": "Damage Filter",
            "type": "string",
            "description": "Filter by primary damage type (e.g. \"FRONT END\", \"REAR END\", \"HAIL\", \"FLOOD\")"
          },
          "location": {
            "title": "Location Filter",
            "type": "string",
            "description": "Filter by auction location/state (e.g. \"CA\", \"TX\", \"FL\")"
          },
          "buyItNowOnly": {
            "title": "Buy It Now Only",
            "type": "boolean",
            "description": "Only lots that offer a Buy It Now price.",
            "default": false
          },
          "odometerMin": {
            "title": "Odometer Min",
            "type": "integer",
            "description": "Minimum odometer reading in miles. Lots with no reading are excluded."
          },
          "odometerMax": {
            "title": "Odometer Max",
            "type": "integer",
            "description": "Maximum odometer reading in miles. Lots with no reading are excluded."
          },
          "currentBidMin": {
            "title": "Current Bid Min",
            "type": "integer",
            "description": "Minimum current bid in USD."
          },
          "currentBidMax": {
            "title": "Current Bid Max",
            "type": "integer",
            "description": "Maximum current bid in USD."
          },
          "saleDateFrom": {
            "title": "Sale Date From",
            "type": "string",
            "description": "Earliest auction date, as YYYY-MM-DD."
          },
          "saleDateTo": {
            "title": "Sale Date To",
            "type": "string",
            "description": "Latest auction date, as YYYY-MM-DD."
          },
          "colors": {
            "title": "Colors",
            "type": "array",
            "description": "Only these exterior colors (e.g. BLACK, WHITE, SILVER).",
            "items": {
              "type": "string"
            }
          },
          "lotNumbers": {
            "title": "Lot Numbers",
            "type": "array",
            "description": "Look up these specific lots instead of searching. Cannot be combined with search filters.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Lot URLs",
            "type": "array",
            "description": "Copart lot URLs (https://www.copart.com/lot/12345678) to look up. Cannot be combined with search filters.",
            "items": {
              "type": "string"
            }
          },
          "enrichDetails": {
            "title": "Add Lot Details",
            "type": "boolean",
            "description": "Adds the full photo gallery, interior color and damage report. Each enriched record is billed as one extra result.",
            "default": false
          },
          "enrichVin": {
            "title": "Decode VIN",
            "type": "boolean",
            "description": "Adds manufacturer, model year, body class, engine and plant data decoded from the VIN. Each decoded record is billed as one extra result.",
            "default": false
          },
          "maxItems": {
            "title": "Max Items",
            "type": "integer",
            "description": "Maximum number of vehicle records to extract",
            "default": 15
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}