{ "openapi": "3.0.1", "info": { "title": "SalvageBid Scraper", "description": "[💰 $1.2 / 1K] Extract salvage & insurance auto auction listings from SalvageBid — VIN, decoded specs, odometer, damage, title type, yard location, current bid, buy-it-now price, sale date, and photos. Filter by make, model, year, damage, title, vehicle type, and 50 US states.", "version": "1.0", "x-build-id": "gWJ6EBEpN7mfkurVN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~salvagebid-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-salvagebid-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/solidcode~salvagebid-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-salvagebid-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/solidcode~salvagebid-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-salvagebid-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": { "startUrls": { "title": "SalvageBid URLs", "type": "array", "description": "Paste SalvageBid links — a search page (https://www.salvagebid.com/search/make-toyota), a category page (https://www.salvagebid.com/salvage-suvs-for-sale/toyota), or a single vehicle page (https://www.salvagebid.com/vehicle/44809092-2016-kia-optima). Any filters already built into the link are kept exactly as they are. If you also pick filters below, those are collected as an additional search rather than being added to your links. Leave empty to use the guided filters only.", "items": { "type": "string" } }, "searchQuery": { "title": "Search", "type": "string", "description": "Search in plain words, e.g. 'toyota camry', '2019 f-150', a VIN, or a stock number. Leave empty to browse without a keyword." }, "makes": { "title": "Makes", "type": "array", "description": "Manufacturer names, e.g. 'Toyota', 'Ford', 'Mercedes-Benz'. Add as many as you like. Leave empty for all makes.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Model names, e.g. 'Camry', 'F-150', 'Silverado'. Leave empty for all models.", "items": { "type": "string" } }, "vehicleTypes": { "title": "Vehicle Types", "uniqueItems": true, "type": "array", "description": "Only collect these kinds of vehicle. Leave empty for everything.", "items": { "type": "string", "enum": [ "cars", "suvs", "pickup-trucks", "medium-duty-trucks", "heavy-duty-trucks", "buses", "motorcycles", "snowmobiles", "jet-skis", "boats", "rvs", "trailers", "farming-equipment", "industrial-equipment", "other" ], "enumTitles": [ "Cars", "SUVs", "Pickup Trucks", "Medium Duty Trucks", "Heavy Duty Trucks", "Buses", "Motorcycles", "Snowmobiles", "Jet Skis", "Boats", "RVs & Motorhomes", "Trailers", "Farming Equipment", "Industrial Equipment", "Other" ] } }, "yearFrom": { "title": "Year From", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only include vehicles from this model year onwards. Leave empty for no lower limit." }, "yearTo": { "title": "Year To", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only include vehicles up to this model year. Leave empty for no upper limit." }, "damageTypes": { "title": "Damage", "uniqueItems": true, "type": "array", "description": "Only include vehicles with these kinds of damage. Leave empty for any damage.", "items": { "type": "string", "enum": [ "Front End", "Rear End", "Front & Rear", "Left Side", "Right Side", "Left & Right", "Left Rear", "Rollover", "Roof", "Undercarriage", "Hail", "Burn", "Interior Burn", "Water/Flood", "Mechanical", "Theft", "Repossession", "Normal Wear", "Unknown" ], "enumTitles": [ "Front End", "Rear End", "Front & Rear", "Left Side", "Right Side", "Left & Right", "Left Rear", "Rollover", "Roof", "Undercarriage", "Hail", "Burn", "Interior Burn", "Water / Flood", "Mechanical", "Theft", "Repossession", "Normal Wear", "Not Specified" ] } }, "titleTypes": { "title": "Title Type", "uniqueItems": true, "type": "array", "description": "Only include vehicles with these titles. Leave empty for all title types.", "items": { "type": "string", "enum": [ "c", "s", "j" ], "enumTitles": [ "Clean Title", "Salvage Title", "Non-Repairable" ] } }, "locationStates": { "title": "States", "uniqueItems": true, "type": "array", "description": "Only include vehicles stored in these US states. Leave empty for all states.", "items": { "type": "string", "enum": [ "alabama", "alaska", "arizona", "arkansas", "california", "colorado", "connecticut", "delaware", "florida", "georgia", "hawaii", "idaho", "illinois", "indiana", "iowa", "kansas", "kentucky", "louisiana", "maine", "maryland", "massachusetts", "michigan", "minnesota", "mississippi", "missouri", "montana", "nebraska", "nevada", "new-hampshire", "new-jersey", "new-mexico", "new-york", "north-carolina", "north-dakota", "ohio", "oklahoma", "oregon", "pennsylvania", "rhode-island", "south-carolina", "south-dakota", "tennessee", "texas", "utah", "vermont", "virginia", "washington", "west-virginia", "wisconsin", "wyoming" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] } }, "saleType": { "title": "How It Sells", "enum": [ "any", "buyItNow", "auction" ], "type": "string", "description": "Choose between vehicles you can buy instantly at a fixed price, or vehicles that go to live auction." }, "sortBy": { "title": "Sort Results By", "enum": [ "default", "saleDateAsc", "saleDateDesc", "yearDesc", "yearAsc", "odometerAsc", "odometerDesc", "currentBidAsc", "currentBidDesc" ], "type": "string", "description": "How to order the vehicles you get back." }, "maxResults": { "title": "Max Results", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Total number of vehicles to collect across everything above — not per link. Start small to preview, then raise it. Set to 0 for no limit (a safety ceiling of 100,000 vehicles still applies). The last page is always kept in full, so you may get a few extra rows. SalvageBid serves at most 10,000 vehicles per search, however many really match, so a single search stops at 10,000 — to collect more, split the job across several searches (for example one state or one year range at a time)." }, "includeDetails": { "title": "Include Full Vehicle Details", "type": "boolean", "description": "Open each vehicle's own page to add 20 extra fields: live bidding info (highest bid, next accepted bid, bidding status, whether preliminary bidding has closed, whether it has already sold), the auction lane and run number, the shipping origin ZIP and yard id, the trim level, the insurer's loss type, the storage yard's street address, the formatted sale location, the 360° spin link, engine and walk-around videos, the main photo, four extra VIN-decoded fields, and a last-updated timestamp. Slower, because each vehicle needs an extra look. This step is best-effort: if a vehicle's own page cannot be opened, or if the extra look-ups for one page of vehicles take longer than about four minutes, the remaining vehicles still arrive with all of their listing information — just without these extra fields. Leave off for a fast run — everything else (VIN, specs, damage, title, current bid, sale date, photos) is already included either way." } } }, "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 } } } } } } } } } }