{ "openapi": "3.0.1", "info": { "title": "Copart Salvage Auctions + NHTSA VIN Specs", "description": "Scrape Copart salvage and clean-title auction lots by make, model or keyword. Get current bids, auction dates, damage, title type, images and NHTSA vehicle specs, plus an estimated margin when Copart publishes value and repair estimates. Incremental mode returns only new lots. $5 per 1,000 lots.", "version": "1.0", "x-build-id": "Rxh9hZ8sihUubFvso" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/radar-scraper~copart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-radar-scraper-copart-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/radar-scraper~copart-scraper/runs": { "post": { "operationId": "runs-sync-radar-scraper-copart-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/radar-scraper~copart-scraper/run-sync": { "post": { "operationId": "run-sync-radar-scraper-copart-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": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "Make, model, or vehicle keyword (e.g., 'ford f-150', 'toyota rav4', 'chevrolet silverado', 'bmw m3').", "default": "ford" }, "portals": { "title": "Auctions to Query", "type": "array", "description": "Auctions to scrape. Copart works on standard datacenter IPs. IAAI is EXPERIMENTAL: its Imperva WAF blocks datacenter IPs, so it needs a RESIDENTIAL proxy (higher cost) and may still return nothing. Off by default.", "items": { "type": "string", "enum": [ "COPART", "IAAI" ], "enumTitles": [ "Copart", "IAAI (experimental: requires RESIDENTIAL proxy, extra cost)" ] }, "default": [ "COPART" ] }, "enrichWithNHTSA": { "title": "Decode VIN with US Government NHTSA API", "type": "boolean", "description": "Enrich each vehicle in batch with official US DOT NHTSA technical specs (engine, displacement, body style, plant).", "default": true }, "onlyArbitrageDeals": { "title": "Filter to Arbitrage Opportunities Only", "type": "boolean", "description": "Only return lots that run and drive, are not parts-only, have bids, have both Copart estimates, a current bid at or below 35% of the retail value, and an estimated gross margin of at least $1,500 (about 8% of lots). The margin uses the current bid, so treat it as an indicative signal.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of lots to return (and charge). About 6 minutes per 1,000 lots.", "default": 30 }, "incrementalMode": { "title": "Incremental mode (only new lots)", "type": "boolean", "description": "When enabled, lots delivered by a previous run of the same search are skipped: not returned and not charged. The history is kept in a named key-value store in your Apify account. The search is identified by Search Query, Auctions and the arbitrage filter; changing Max Items or the proxy keeps the history. Two runs of the same search at the same time may re-deliver a few items on the next run.", "default": false }, "stateKey": { "title": "Incremental history key (optional)", "type": "string", "description": "Optional name for the incremental history (letters, digits and ! - _ . ' ( ) only). Leave empty to derive it from the search. Set it to keep one history across searches." }, "resetIncrementalState": { "title": "Reset incremental history", "type": "boolean", "description": "Deletes the incremental history of this search before running, so every item is delivered as new.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. By default uses standard Datacenter proxies to safeguard PPE margins." } } }, "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 } } } } } } } } } }