{ "openapi": "3.0.1", "info": { "title": "Bring a Trailer Scraper", "description": "[💰 $8 / 1K] Extract car & vehicle auction listings from Bring a Trailer. Get current bids, final sold prices, reserve status, specs, seller location, photos, and more. Search by make/model or filter by category, era, and origin.", "version": "1.0", "x-build-id": "dW1avYIiWrJ2nDoIN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~bringatrailer-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-bringatrailer-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~bringatrailer-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-bringatrailer-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~bringatrailer-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-bringatrailer-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": "Start URLs", "type": "array", "description": "Paste Bring a Trailer links — an auctions page, a make or model page (e.g. https://bringatrailer.com/porsche/911/), a category page, or a single listing. Any filters already built into the URL are kept as-is. Leave empty to see current live auctions, or if you are only using Search by Make / Model below. Links to auctions that have since been removed or renamed are skipped with a note, never saved as blank results.", "items": { "type": "string" } }, "searchQueries": { "title": "Search by Make / Model", "type": "array", "description": "Search in plain text, e.g. 'Porsche 911', 'Toyota Land Cruiser', or just 'Ferrari'. Each query is matched to the right Bring a Trailer page automatically — no need to build URLs by hand.", "items": { "type": "string" } }, "listingType": { "title": "Auction Status", "enum": [ "live", "sold" ], "type": "string", "description": "Which auctions to collect: Live (currently running, with the current high bid) or Sold (completed results, with the final sale price). Applies to search queries and filters. URLs you paste keep their own status.", "default": "live" }, "category": { "title": "Categories", "uniqueItems": true, "type": "array", "description": "Only include these categories. Leave empty for all categories.", "items": { "type": "string", "enum": [ "aircraft", "atvs", "boats", "charity", "convertibles", "electric-vehicles", "go-karts", "hot-rods", "kei-vehicles", "military-vehicles", "minibikes-scooters", "motorcycles", "parts", "projects", "race-cars", "right-hand-drive", "rvs-campers", "service-vehicles", "side-by-sides", "station-wagons", "tractors", "trains", "trucks-4x4", "vans", "wheels" ], "enumTitles": [ "Aircraft", "All-Terrain Vehicles", "Boats", "Charity & Non-Profit", "Convertibles", "Electric Vehicles", "Go-Karts", "Hot Rods", "Kei Vehicles", "Military Vehicles", "Minibikes & Scooters", "Motorcycles", "Parts", "Projects", "Race Cars", "Right-Hand Drive", "RVs & Campers", "Service Vehicles", "Side-by-Sides", "Station Wagons", "Tractors", "Trains", "Truck & 4x4", "Vans", "Wheels" ] }, "default": [] }, "era": { "title": "Eras (Decades)", "uniqueItems": true, "type": "array", "description": "Only include vehicles from these decades. Leave empty for all eras.", "items": { "type": "string", "enum": [ "2020s", "2010s", "2000s", "1990s", "1980s", "1970s", "1960s", "1950s", "1940s", "1930s", "1920s", "1910s", "1900s", "pre-1900" ], "enumTitles": [ "2020s", "2010s", "2000s", "1990s", "1980s", "1970s", "1960s", "1950s", "1940s", "1930s", "1920s", "1910s", "1900s", "Pre-1900" ] }, "default": [] }, "origin": { "title": "Country of Origin", "uniqueItems": true, "type": "array", "description": "Only include vehicles from these countries of origin. Leave empty for all origins.", "items": { "type": "string", "enum": [ "american", "brazilian", "british", "canadian", "czech", "dutch", "french", "german", "italian", "japanese", "korean", "prewar", "spanish", "swedish" ], "enumTitles": [ "American", "Brazilian", "British", "Canadian", "Czech", "Dutch", "French", "German", "Italian", "Japanese", "Korean", "Prewar", "Spanish", "Swedish" ] }, "default": [] }, "noReserveOnly": { "title": "No Reserve Only", "type": "boolean", "description": "Only return No Reserve auctions — these are guaranteed to sell to the highest bidder with no minimum price.", "default": false }, "maxBid": { "title": "Maximum Bid (USD)", "minimum": 0, "type": "integer", "description": "Only include auctions whose current bid is at or below this amount, in US dollars. Leave empty for no price cap." }, "sortBy": { "title": "Sort Results By", "enum": [ "ending_soonest", "ending_latest", "bid_high", "bid_low" ], "type": "string", "description": "Order the results. Completed (sold) auctions have no future end date, so on sold results \"Ending soonest\" means the oldest sales first and \"Ending latest\" means the most recent sales first. \"Bid: lowest first\" applies to live auctions only — Bring a Trailer ranks completed sales by closing date, highest price or popularity, with no cheapest-first option, so a sold run that picks it is collected as \"Ending latest\" and says so on the run status. To target lower-priced completed sales, use the Maximum Bid cap instead. Leave this empty to get the best order for what you are collecting: closing soonest for live auctions, most recently sold for completed ones." }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of auctions to return across all URLs and searches. Set to 0 for unlimited. Note: Bring a Trailer serves at most about 9,960 completed (sold) auctions per search, no matter how many match — to collect more than that, split the job into narrower searches by make, model, era, origin or category, or use the Maximum Bid cap. Live auctions are not affected. Tip: start with 10-50 to test, then increase.", "default": 100 }, "includeDetails": { "title": "Include Full Listing Details", "type": "boolean", "description": "Open each listing's page to collect the full description, all photos, decoded vehicle specs (VIN, mileage, engine, transmission), seller type and username, and exact bid / comment / view / watcher counts. Much richer data, but slower and more costly. Leave off for fast list-level data (bids, price, location, end date). Note: specs and bid / comment counts are only available with this option turned on.", "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 } } } } } } } } } }