{ "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": "kX7YVoXELteKpPWcy" }, "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.", "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.", "default": "ending_soonest" }, "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. 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 } } }, "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 } } } } } } } } } }