{ "openapi": "3.0.1", "info": { "title": "Copart Auctions Scraper: Salvage & Used Cars, Bids, Damage", "description": "Copart US salvage and used vehicle lots from any search: year, make, model, VIN, damage, title, odometer, estimated value, repair cost, current bid, Buy It Now, auction date, yard and photo. Filters, deal sorting, alerts and AI deal reads.", "version": "0.1", "x-build-id": "GktviM3jauncuvup6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tacps126~copart-auctions/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tacps126-copart-auctions", "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/tacps126~copart-auctions/runs": { "post": { "operationId": "runs-sync-tacps126-copart-auctions", "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/tacps126~copart-auctions/run-sync": { "post": { "operationId": "run-sync-tacps126-copart-auctions", "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": { "query": { "title": "Search words", "type": "string", "description": "Free text as typed in Copart's search box (matches loosely, e.g. \"tesla\"). For exact vehicles use Makes and Models." }, "makes": { "title": "Makes", "type": "array", "description": "e.g. TOYOTA, HONDA, FORD.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Model groups, e.g. CAMRY, CIVIC, F150.", "items": { "type": "string" } }, "yearFrom": { "title": "Year from", "minimum": 1900, "type": "integer", "description": "Model year, inclusive." }, "yearTo": { "title": "Year to", "minimum": 1900, "type": "integer", "description": "Model year, inclusive." }, "maxOdometer": { "title": "Max odometer (miles)", "minimum": 0, "type": "integer", "description": "Leave out lots with more miles." }, "damage": { "title": "Primary damage", "type": "array", "description": "Empty = any damage.", "items": { "type": "string", "enum": [ "allOver", "biohazard", "burn", "burnEngine", "burnInterior", "damageHistory", "frame", "frontEnd", "hail", "mechanical", "minorDents", "missingVin", "normalWear", "partialRepair", "rearEnd", "rejectedRepair", "rollover", "side", "stripped", "roof", "undercarriage", "unknown", "vandalism", "flood" ], "enumTitles": [ "All over", "Biohazard / chemical", "Burn", "Burn - engine", "Burn - interior", "Damage history", "Frame damage", "Front end", "Hail", "Mechanical", "Minor dents / scratches", "Missing / altered VIN", "Normal wear", "Partial repair", "Rear end", "Rejected repair", "Rollover", "Side", "Stripped", "Top / roof", "Undercarriage", "Unknown", "Vandalism", "Water / flood" ] } }, "titleTypes": { "title": "Title", "type": "array", "description": "Empty = any title.", "items": { "type": "string", "enum": [ "clean", "salvage", "nonRepairable" ], "enumTitles": [ "Clean title", "Salvage title", "Non-repairable" ] } }, "vehicleTypes": { "title": "Vehicle type", "type": "array", "description": "Empty = any type.", "items": { "type": "string", "enum": [ "automobile", "suv", "pickup", "motorcycle", "atv", "rv", "boxTruck", "heavyTruck", "industrial", "construction" ], "enumTitles": [ "Automobiles", "SUVs", "Pickup trucks", "Motorcycles", "ATVs", "RVs", "Medium duty box trucks", "Heavy duty trucks", "Industrial equipment", "Construction equipment" ] } }, "features": { "title": "Sale features", "type": "array", "description": "Every feature you pick must apply.", "items": { "type": "string", "enum": [ "buyItNow", "runAndDrive", "engineStarts", "pureSale", "noLicenseRequired", "rental", "recoveredTheft", "fleetLease", "repossession", "donation", "electric", "hybrid" ], "enumTitles": [ "Buy It Now", "Run and Drive", "Engine starts", "Pure sale (no reserve)", "No license required", "Rentals", "Recovered thefts", "Fleet / lease", "Repossessions", "Donations", "Electric", "Hybrid" ] } }, "states": { "title": "Yard states", "type": "array", "description": "Two-letter US state or Canadian province codes of the yard, e.g. TX, CA, ON.", "items": { "type": "string" } }, "auctionWithinDays": { "title": "Auction within N days", "minimum": 1, "maximum": 60, "type": "integer", "description": "Only lots whose auction is scheduled in the next N days." }, "addedWithinDays": { "title": "Added within N days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only lots assigned to a sale in the last N days (new arrivals)." }, "maxRepairCost": { "title": "Max repair cost (USD)", "minimum": 0, "type": "integer", "description": "Copart's estimated repair cost." }, "minEstimatedValue": { "title": "Min estimated retail value (USD)", "minimum": 0, "type": "number", "description": "Copart's estimated retail value, repaired." }, "maxCurrentBid": { "title": "Max current bid (USD)", "minimum": 0, "type": "number", "description": "Leave out lots whose current bid is higher." }, "maxBidToValue": { "title": "Max bid / value", "minimum": 0, "maximum": 1, "type": "number", "description": "Current bid as a share of the estimated value, e.g. 0.3 for bids at 30% of value or less." }, "sortBy": { "title": "Sort by", "enum": [ "auctionDate", "bidToValue", "value", "year", "odometer" ], "type": "string", "description": "Order of the results.", "default": "auctionDate" }, "maxItems": { "title": "Max lots", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Most lots returned.", "default": 100 }, "onlyNew": { "title": "Only new lots", "type": "boolean", "description": "Schedule the Actor (daily or hourly) and each run returns only lots that earlier runs did not deliver: new arrivals for your search.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the \"only new\" history, so several monitors can run side by side." }, "tenantId": { "title": "Tenant ID", "type": "string", "description": "Optional label used to keep separate histories for different clients or teams." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave as is unless runs are refused.", "default": { "useApifyProxy": false } }, "aiInsights": { "title": "AI insights", "type": "boolean", "description": "Add an `insight` to each lot: deal rating at the current bid, risks to check and a note on a sensible maximum bid; with a profile, how well it fits you.", "default": false }, "aiProfile": { "title": "Your profile (for the fit score)", "type": "string", "description": "What you buy, e.g. \"Rebuilder in Texas, buys 2016+ Toyota and Honda sedans with front or rear damage, sells retail\". Adds a fit score." }, "aiLanguage": { "title": "Insight language", "type": "string", "description": "Insights are written in this language, whatever the source language.", "default": "English" }, "maxInsights": { "title": "Max insights per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Insights are added to the first N lots (in the sort order).", "default": 25 }, "aiProvider": { "title": "AI provider", "enum": [ "apify", "anthropic", "openai", "gemini", "openrouter", "groq", "mistral", "deepseek", "compatible" ], "type": "string", "description": "Which AI does the analysis. Apify needs no key: the model's tokens are billed to your Apify account by Apify's AI gateway (a fraction of a cent per call with the default model). Any other provider uses your own key and bills you there.", "default": "apify" }, "aiApiKey": { "title": "AI API key", "type": "string", "description": "Your own key for the provider above (not needed for Apify). Sent only to that provider, never stored." }, "aiModel": { "title": "AI model", "type": "string", "description": "Model name. Apify: an OpenRouter id like anthropic/claude-sonnet-... or google/gemini-... (default: the newest Claude Haiku listed, a light model since it runs once per result). Anthropic: default claude-opus-5-5. Others: required." }, "aiBaseUrl": { "title": "API base URL", "type": "string", "description": "Only for \"Other OpenAI-compatible API\", e.g. http://localhost:11434/v1 for Ollama." }, "debug": { "title": "Debug", "type": "boolean", "description": "Save extra diagnostics with the run (for support requests).", "default": false } } }, "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 } } } } } } } } } }