{ "openapi": "3.0.1", "info": { "title": "Autotrader.com Vehicle Scraper + Instant Results", "description": "Scrape Autotrader.com (USA) vehicles by make, model, year, price, and mileage. Features exact listing dates, smart age filtering, and deduplication. Optimized for lowest cost per run using advanced extraction techniques. Get instant vehicle results with filtering for private listings only.", "version": "0.0", "x-build-id": "6zuykun6rlNqyQXPo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raidr-api~autotrader-us-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raidr-api-autotrader-us-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/raidr-api~autotrader-us-scraper/runs": { "post": { "operationId": "runs-sync-raidr-api-autotrader-us-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/raidr-api~autotrader-us-scraper/run-sync": { "post": { "operationId": "run-sync-raidr-api-autotrader-us-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": [ "zipcode" ], "properties": { "zipcode": { "title": "πŸ“ ZIP Code", "type": "string", "description": "ZIP code used as the center point for the search.", "default": "90001" }, "searchRadius": { "title": "πŸ—ΊοΈ Search Radius (miles)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Distance around the ZIP code, in miles. Use 0 for a nationwide search.", "default": 50 }, "maxItems": { "title": "πŸ“¦ Maximum Results", "minimum": 1, "type": "integer", "description": "Maximum number of unique listings to save. Note: AutoTrader caps a single search at ~400 records β€” pulls above that are automatically sliced by make/price/year for coverage.", "default": 500 }, "sort": { "title": "↕️ Sort Results By", "enum": [ "newest", "relevance" ], "type": "string", "description": "Ordering for results (applies within each slice when a large pull is sliced).", "default": "newest" }, "fetchDetails": { "title": "πŸ”Ž Fetch Full Details", "type": "boolean", "description": "Also open each listing's detail page to add the seller description, full feature list, warranties, stock number, dealer rating, and the complete image set. Slower and uses more proxy bandwidth (one extra ~0.5 MB page per listing).", "default": false }, "make": { "title": "🚘 Makes", "uniqueItems": true, "type": "array", "description": "Filter by one or more makes. Leave empty to include all makes.", "items": { "type": "string", "enum": [ "Acura", "Alfa Romeo", "Aston Martin", "Audi", "Bentley", "BMW", "Buick", "Cadillac", "Chevrolet", "Chrysler", "Dodge", "Ferrari", "Fiat", "Ford", "Genesis", "GMC", "Honda", "Hummer", "Hyundai", "Infiniti", "Jaguar", "Jeep", "Kia", "Lamborghini", "Land Rover", "Lexus", "Lincoln", "Lotus", "Lucid", "Maserati", "Mazda", "McLaren", "Mercedes-Benz", "Mini", "Mitsubishi", "Nissan", "Polestar", "Porsche", "Ram", "Rivian", "Rolls-Royce", "Subaru", "Tesla", "Toyota", "Volkswagen", "Volvo" ] } }, "minPrice": { "title": "πŸ’΅ Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum price in USD. Leave empty for no minimum." }, "maxPrice": { "title": "πŸ’° Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum price in USD. Leave empty for no maximum." }, "minYear": { "title": "πŸ“… Minimum Year", "minimum": 1900, "type": "integer", "description": "Minimum model year. Leave empty for no minimum." }, "maxYear": { "title": "πŸ“… Maximum Year", "minimum": 1900, "type": "integer", "description": "Maximum model year. Leave empty for no maximum." }, "maxMileage": { "title": "🧭 Maximum Mileage", "minimum": 0, "type": "integer", "description": "Only include vehicles at or below this odometer reading. Leave empty for no limit." }, "condition": { "title": "🏷️ Condition", "uniqueItems": true, "type": "array", "description": "Filter by listing condition. Leave empty to include all.", "items": { "type": "string", "enum": [ "new", "used", "certified", "third-party-certified" ], "enumTitles": [ "New", "Used", "Certified Pre-Owned", "Third-Party Certified" ] } }, "bodyType": { "title": "πŸš™ Body Styles", "uniqueItems": true, "type": "array", "description": "Filter by body style. Leave empty to include all.", "items": { "type": "string", "enum": [ "sedan", "suv", "truck", "coupe", "hatchback", "wagon", "van", "convertible" ], "enumTitles": [ "Sedan", "SUV / Crossover", "Truck", "Coupe", "Hatchback", "Wagon", "Van / Minivan", "Convertible" ] } }, "fuelType": { "title": "β›½ Fuel Types", "uniqueItems": true, "type": "array", "description": "Filter by fuel type. Leave empty to include all.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "electric", "hybrid", "plug-in-hybrid" ], "enumTitles": [ "Gasoline", "Diesel", "Electric", "Hybrid", "Plug-in Hybrid" ] } }, "driveType": { "title": "πŸ›ž Drivetrains", "uniqueItems": true, "type": "array", "description": "Filter by drivetrain. Leave empty to include all.", "items": { "type": "string", "enum": [ "awd", "fwd", "rwd" ], "enumTitles": [ "AWD / 4WD", "Front-Wheel Drive", "Rear-Wheel Drive" ] } }, "cylinders": { "title": "πŸ”§ Engine Cylinders", "uniqueItems": true, "type": "array", "description": "Filter by engine cylinder count. Leave empty to include all.", "items": { "type": "string", "enum": [ "3", "4", "5", "6", "8", "10", "12", "16", "rotary" ], "enumTitles": [ "3 Cylinder", "4 Cylinder", "5 Cylinder", "6 Cylinder", "8 Cylinder", "10 Cylinder", "12 Cylinder", "16 Cylinder", "Rotary" ] } }, "doors": { "title": "πŸšͺ Doors", "uniqueItems": true, "type": "array", "description": "Filter by number of doors. Leave empty to include all.", "items": { "type": "string", "enum": [ "2", "3", "4", "5" ], "enumTitles": [ "2 Doors", "3 Doors", "4 Doors", "5 Doors" ] } }, "exteriorColor": { "title": "🎨 Exterior Colors", "uniqueItems": true, "type": "array", "description": "Filter by exterior color. Leave empty to include all.", "items": { "type": "string", "enum": [ "beige", "black", "blue", "brown", "burgundy", "charcoal", "gold", "gray", "green", "off-white", "orange", "pink", "purple", "red", "silver", "tan", "turquoise", "white", "yellow" ], "enumTitles": [ "Beige", "Black", "Blue", "Brown", "Burgundy", "Charcoal", "Gold", "Gray", "Green", "Off White", "Orange", "Pink", "Purple", "Red", "Silver", "Tan", "Turquoise", "White", "Yellow" ] } }, "interiorColor": { "title": "πŸͺ‘ Interior Colors", "uniqueItems": true, "type": "array", "description": "Filter by interior color. Leave empty to include all.", "items": { "type": "string", "enum": [ "beige", "black", "blue", "brown", "burgundy", "charcoal", "gold", "gray", "green", "off-white", "orange", "pink", "purple", "red", "silver", "tan", "turquoise", "white", "yellow" ], "enumTitles": [ "Beige", "Black", "Blue", "Brown", "Burgundy", "Charcoal", "Gold", "Gray", "Green", "Off White", "Orange", "Pink", "Purple", "Red", "Silver", "Tan", "Turquoise", "White", "Yellow" ] } }, "dealRating": { "title": "πŸ† Deal Rating", "uniqueItems": true, "type": "array", "description": "Only include listings AutoTrader flags with these deal ratings. Leave empty to include all.", "items": { "type": "string", "enum": [ "great", "good" ], "enumTitles": [ "Great Price", "Good Price" ] } }, "vehicleHistory": { "title": "πŸ“œ Vehicle History", "uniqueItems": true, "type": "array", "description": "Filter by vehicle history attributes. Leave empty to include all.", "items": { "type": "string", "enum": [ "clean-title", "no-accidents", "no-frame-damage", "one-owner", "free-report" ], "enumTitles": [ "Clean Title", "No Accidents", "No Frame Damage", "Single Owner", "Free History Report" ] } }, "homeServices": { "title": "🏠 At-Home Services", "uniqueItems": true, "type": "array", "description": "Filter by at-home buying services offered. Leave empty to include all.", "items": { "type": "string", "enum": [ "video-walkaround", "home-test-drive", "online-paperwork", "home-delivery", "buy-online" ], "enumTitles": [ "Video Walkaround", "Test Drive at Home", "Online Paperwork", "Local Home Delivery", "Buy Online" ] } }, "transmission": { "title": "βš™οΈ Transmission", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Filter by transmission type.", "default": "" }, "sellerType": { "title": "πŸ§‘β€πŸ’Ό Seller Type", "enum": [ "", "dealer", "private" ], "type": "string", "description": "Filter by seller type.", "default": "" }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended in production (AutoTrader is behind Akamai; datacenter IPs are usually challenged).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }