{ "openapi": "3.0.1", "info": { "title": "Autotrader.ca Vehicle Scraper + Instant Results", "description": "Scrape Autotrader.ca (Canada) 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": "jWtaxh6opemKJwB8Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raidr-api~autotrader-ca-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raidr-api-autotrader-ca-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-ca-scraper/runs": { "post": { "operationId": "runs-sync-raidr-api-autotrader-ca-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-ca-scraper/run-sync": { "post": { "operationId": "run-sync-raidr-api-autotrader-ca-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": [ "location" ], "properties": { "location": { "title": "City/Postal Code", "type": "string", "description": "Enter a postal code (e.g., M5H2N2) or city with 2-letter province code (e.g., Toronto, ON). Do NOT use full province names like 'Ontario' — use the abbreviation 'ON' instead.", "default": "Toronto, ON" }, "radius": { "title": "🎯 Search Radius", "minimum": 10, "maximum": 400, "type": "integer", "description": "Search radius in kilometers (recommended: 10, 20, 50, 100, 150, 200, 250, 300, 400)", "default": 100 }, "sorting": { "title": "🔄 Sort Results By", "enum": [ "default", "posted_date_new_to_old", "posted_date_old_to_new", "price_highest_to_lowest", "price_lowest_to_highest", "year_new_to_old", "year_old_to_new", "kilometres_lowest_to_highest", "kilometres_highest_to_lowest", "location_nearest" ], "type": "string", "description": "Sort order for listings", "default": "default" }, "maxResults": { "title": "📊 Maximum Results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited)", "default": 100 }, "vehicleCondition": { "title": "Vehicle Condition", "uniqueItems": true, "type": "array", "description": "Select vehicle condition(s). Leave empty to show all.", "items": { "type": "string", "enum": [ "N", "U", "J", "O", "D", "S" ], "enumTitles": [ "New", "Used", "Employee's car", "Antique/Classic", "Demonstration", "Pre-registered" ] } }, "seller": { "title": "Seller Type", "enum": [ "all", "D", "P" ], "type": "string", "description": "Type of seller", "default": "all" }, "make": { "title": "Vehicle Make", "enum": [ "0", "14979", "52017", "16356", "6", "52018", "52019", "52009", "52021", "52020", "51545", "8", "52022", "9", "15643", "11", "13", "52010", "15", "16", "17", "19", "20", "21", "22", "23", "52023", "51779", "2152", "52035", "51678", "52024", "27", "28", "51543", "29", "52011", "51885", "52025", "2153", "52012", "31", "15674", "33", "51925", "16355", "52026", "35", "37", "38", "51910", "51875", "39", "40", "41", "42", "15641", "43", "14890", "44", "51921", "45", "16348", "46", "51519", "47", "51834", "52036", "48", "16338", "50", "52027", "52", "53", "55", "51770", "51817", "56", "57", "51793", "52028", "60", "52013", "61", "62", "63", "52029", "52014", "52015", "64", "51896", "15525", "16377", "52043", "51833", "67", "51748", "68", "51520", "70", "2120", "16328", "51809", "51915", "74", "73", "52030", "52037" ], "type": "string", "description": "Select vehicle manufacturer. Leave as 'All' to show all makes.", "default": "0" }, "modelYearFrom": { "title": "📅 Model Year From", "minimum": 0, "maximum": 2026, "type": "integer", "description": "Minimum model year (use 0 for no minimum)", "default": 2017 }, "modelYearTo": { "title": "📅 Model Year To", "minimum": 0, "maximum": 2026, "type": "integer", "description": "Maximum model year (use 0 for no maximum)", "default": 2026 }, "priceFrom": { "title": "💰 Price From ($)", "minimum": 0, "maximum": 9999999, "type": "integer", "description": "Minimum price in dollars (use 0 for no minimum)", "default": 0 }, "priceTo": { "title": "💰 Price To ($)", "minimum": 0, "maximum": 9999999, "type": "integer", "description": "Maximum price in dollars (use 0 for no maximum)", "default": 0 }, "priceBadgeGreatPrice": { "title": "Great Price Badge", "type": "boolean", "description": "Include vehicles with 'Great Price' badge", "default": false }, "priceBadgeGoodPrice": { "title": "Good Price Badge", "type": "boolean", "description": "Include vehicles with 'Good Price' badge", "default": false }, "priceBadgeFairPrice": { "title": "Fair Price Badge", "type": "boolean", "description": "Include vehicles with 'Fair Price' badge", "default": false }, "priceBadgeAboveAverage": { "title": "Above Average Badge", "type": "boolean", "description": "Include vehicles with 'Above Average' price badge", "default": false }, "bodyType": { "title": "🚙 Body Type", "uniqueItems": true, "type": "array", "description": "Select body type(s). Leave empty to show all.", "items": { "type": "string", "enum": [ "1", "2", "3", "5", "6", "12", "14", "15", "7" ], "enumTitles": [ "Hatchback", "Convertible", "Coupe", "Wagon", "Sedan", "Minivan", "SUV", "Pick-up Truck", "Other" ] } }, "exteriorColor": { "title": "🎨 Exterior Color", "uniqueItems": true, "type": "array", "description": "Select exterior color(s). Leave empty to show all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "10", "11", "12", "13", "14", "15", "16" ], "enumTitles": [ "Beige", "Blue", "Brown", "Bronze", "Yellow", "Grey", "Green", "Red", "Black", "Silver", "Violet", "White", "Orange", "Gold" ] } }, "kmFrom": { "title": "🛣️ Mileage From (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage in kilometers (use 0 for no minimum)", "default": 0 }, "kmTo": { "title": "🛣️ Mileage To (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometers (use 0 for no maximum)", "default": 0 }, "driveTrain": { "title": "Drive Train", "uniqueItems": true, "type": "array", "description": "Select drivetrain type(s). Leave empty to show all.", "items": { "type": "string", "enum": [ "A", "F", "R", "X" ], "enumTitles": [ "All Wheel Drive", "Front Wheel Drive", "Rear Wheel Drive", "4x4" ] } }, "fuelType": { "title": "⛽ Fuel Type", "uniqueItems": true, "type": "array", "description": "Select fuel type(s). Leave empty to show all.", "items": { "type": "string", "enum": [ "2", "B", "C", "D", "E", "F", "L", "O" ], "enumTitles": [ "Gas/Electric Hybrid", "Gasoline", "Natural Gas", "Diesel", "Electric", "Flex Fuel", "Propane (LPG)", "Unknown" ] } }, "cylinders": { "title": "Engine Cylinders", "uniqueItems": true, "type": "array", "description": "Select number of cylinders. Leave empty to show all.", "items": { "type": "string", "enum": [ "3", "4", "6", "8", "10plus" ], "enumTitles": [ "3 cylinder", "4 cylinder", "6 cylinder", "8 cylinder", "10+ cylinder" ] } }, "transmission": { "title": "⚙️ Transmission", "uniqueItems": true, "type": "array", "description": "Select transmission type(s). Leave empty to show all.", "items": { "type": "string", "enum": [ "A", "M" ], "enumTitles": [ "Automatic", "Manual" ] } }, "seatsFrom": { "title": "🪑 Seating From", "minimum": 0, "maximum": 12, "type": "integer", "description": "Minimum seating capacity (use 0 for no minimum)", "default": 0 }, "seatsTo": { "title": "🪑 Seating To", "minimum": 0, "maximum": 12, "type": "integer", "description": "Maximum seating capacity (use 0 for no maximum)", "default": 0 }, "doors": { "title": "🚪 Number of Doors", "enum": [ "all", "2-3", "4-5", "6-7" ], "type": "string", "description": "Select number of doors", "default": "all" }, "equipment": { "title": "🎯 Equipment & Features", "uniqueItems": true, "type": "array", "description": "Select desired equipment and features. Leave empty to show all vehicles.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "10", "11", "12", "13", "15", "16", "17", "18", "19", "20", "21", "23", "25", "26", "27", "28", "29", "30", "31", "32", "34", "36", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "50", "52", "54", "111", "112", "113", "114", "115", "116", "117", "118", "119", "121", "122", "123", "124", "125", "126", "127", "128", "129", "130", "131", "132", "133", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "144", "145", "146", "147", "148", "149", "150", "151", "152", "153", "154", "155", "156", "157", "158", "159", "160", "161", "162", "170", "173", "174", "187", "189", "190", "210", "211", "212", "213", "214", "215", "216", "217", "218", "219", "220", "221", "222", "223", "224", "225", "226", "227", "228", "229", "230", "231", "232", "233", "237", "238", "239", "240", "241", "242", "243", "244", "245", "248", "249", "250", "251" ], "enumTitles": [ "ABS", "Driver-side airbag", "Passenger-side airbag", "Sunroof", "Air conditioning", "Leather seats", "Radio", "4WD", "Power steering", "Power windows", "Alloy wheels", "Power Seats", "Central door lock", "Alarm system", "Fog lights", "Trailer hitch", "Split rear seats", "Navigation system", "Winter Tires", "Immobilizer", "Roof rack", "Tuned car", "Catalytic Converter", "Automatic climate control", "Traction control", "Side airbag", "Heated Seats", "Wheelchair Accessible", "Cruise control", "Xenon headlights", "Park Distance Control", "On-board computer", "Electronic stability control", "MP3", "Wind deflector", "Rear airbag", "Head airbag", "Central door lock with remote control", "Right-hand drive", "Panoramic Roof", "Auxiliary heating", "Tinted windows", "Cab or rented Car", "Sport package", "Start-stop system", "Multi-function steering wheel", "Daytime running lights", "Sport suspension", "Sport seats", "Adaptive headlights", "Ski bag", "Power Mirrors", "Bluetooth", "Heads-up display", "Hands-free equipment", "Isofix", "Light sensor", "Rain sensor", "Parking Assist Front Sensors", "Parking Assist Rear Sensors", "Parking assist system camera", "Automatic Parking Assist", "CD player", "Adaptive Cruise Control", "Armrest", "Heated Windshield", "Heated steering wheel", "Hill-Start Assist", "Digital radio", "Power Tailgate", "LED Headlights", "LED Daytime Running Lights", "Leather steering wheel", "Lumbar support", "Air suspension", "Massage seats", "Driver drowsiness detection", "Night view assist", "Emergency Brake Assist", "Emergency system", "Tire pressure monitoring system", "Shift paddles", "Sliding door", "Remote Keyless Entry", "Cooled Seats", "Sound system", "Voice Control", "Lane departure warning system", "Blind spot monitor", "Touch screen", "Television", "USB", "Traffic sign recognition", "Biodiesel conversion", "E10-enabled", "Awning", "360° camera", "High beam assist", "Headlight washer system", "Summer Tires", "All Season Tires", "Steel wheels", "Laser headlights", "Glare-free high beam headlights", "Spare Tire", "Emergency Tire", "Emergency Tire Repair Kit", "Smoker's package", "Ambient lighting", "Hotspot", "Apple CarPlay", "Android Auto", "Wireless Charging", "Digital cockpit", "Auto Dimming Rearview Mirror", "Cargo barrier", "Speed Limit Assist", "Integrated music streaming", "Fold flat passenger seat", "Bi-Xenon headlights", "Winter package", "Distance warning system", "Power Rear Seats", "Range extender", "Spoiler", "Full-LED headlights", "Electronic parking brake", "Automatic Climate Control, Dual-Zone", "Automatic Climate Control, Tri-Zone", "Automatic Climate Control, Quad-Zone", "Sliding Door Driver-Side", "Sliding Door Passenger-Side", "Rear seat heating", "Heat Pump", "Bidirectional Charging", "Battery certificate" ] }, "default": [] }, "onlineSince": { "title": "📅 Online Since (days)", "minimum": 0, "maximum": 14, "type": "integer", "description": "Show listings posted within the last X days (0 = All, max 14)", "default": 0 }, "keywords": { "title": "🔍 Keywords", "type": "string", "description": "Search keywords in listing titles (comma-separated, e.g., xDrive, BlueMotion)", "default": "" }, "enableDeduplication": { "title": "Skip Previously Seen Items", "type": "boolean", "description": "Avoid re-processing items that were collected in previous runs", "default": true }, "deduplicationStoreName": { "title": "Deduplication Storage", "type": "string", "description": "Storage name for tracking previously seen items", "default": "autotrader-seen-items" }, "discordWebhookUrl": { "title": "Discord Webhook URL", "type": "string", "description": "Webhook URL for sending notifications to Discord (leave empty to disable)", "default": "" }, "discordNotifyOnlyNew": { "title": "Notify Only New Items", "type": "boolean", "description": "Send notifications only for items not seen in previous runs", "default": true }, "discordMaxItemsPerMessage": { "title": "Items per Notification", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum listings to include in each Discord message", "default": 5 }, "discordImageDisplay": { "title": "Image Display Style", "enum": [ "thumbnail", "full", "none" ], "type": "string", "description": "How to display images in Discord notifications", "default": "thumbnail" } } }, "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 } } } } } } } } } }