{ "openapi": "3.0.1", "info": { "title": "AutoTrader.ca Price Drop Monitor & Car Scraper", "description": "Monitor AutoTrader Canada searches and get only new listings, price drops and sold cars since the last run, with previous price and price history. Schedule it daily. Or scrape every listing: price, VIN, mileage, specs, dealer phone and photos.", "version": "0.0", "x-build-id": "CJcfBiBD18Ek1ZqWU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fayoussef~autotrader-ca/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fayoussef-autotrader-ca", "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/fayoussef~autotrader-ca/runs": { "post": { "operationId": "runs-sync-fayoussef-autotrader-ca", "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/fayoussef~autotrader-ca/run-sync": { "post": { "operationId": "run-sync-fayoussef-autotrader-ca", "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": { "start_urls": { "title": "Start URLs", "type": "array", "description": "Search or listing URLs copied from autotrader.ca. Set your filters on the site, copy the address bar, paste it here. Direct listing URLs (/offers/... or /a/...) also work and skip straight to that vehicle, but only with the monitor off: the monitor watches searches. This field takes precedence: anything here means the Search filters section below is ignored. Leave it empty to search by filters instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "max_items": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many vehicles, even if more pages match. Leave empty for no limit. Use this for an exact number: pages hold 100 listings each, so End page can only limit the output in steps of 100. With the monitor on, this caps change rows per run; changes over the cap are reported on the next run." }, "monitor_mode": { "title": "Price-drop monitor", "type": "boolean", "description": "Turn this on and schedule the run (daily is typical). The first run saves the current listings as a baseline. Every later run returns only what changed since the previous run: new listings, price drops, price increases and sold or removed vehicles, each with the previous price, the change and a price history. Off: a normal full scrape of every listing.", "default": false }, "report_changes": { "title": "Changes to report", "type": "array", "description": "Which changes become rows. Price increases are off by default. Changes that are not selected are still tracked, so the comparison stays accurate.", "items": { "type": "string", "enum": [ "new", "price_drop", "price_increase", "removed" ], "enumTitles": [ "New listings", "Price drops", "Price increases", "Sold or removed" ] }, "default": [ "new", "price_drop", "removed" ] }, "min_price_change_cad": { "title": "Minimum price change (CAD)", "minimum": 1, "type": "integer", "description": "Ignore price changes smaller than this many dollars. Leave empty to report every change." }, "min_price_change_pct": { "title": "Minimum price change (%)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Ignore price changes smaller than this percentage of the previous price. Leave empty to report every change. If both minimums are set, a change must pass both." }, "export_baseline": { "title": "Export all listings on the first run", "type": "boolean", "description": "On: the first run also outputs every current listing (marked \"baseline\"), so you start with the full picture. Off: the first run only saves the baseline and outputs nothing.", "default": true }, "watchlist_name": { "title": "Watchlist name (optional)", "type": "string", "description": "Leave empty: each search keeps its own history automatically. Set a name to keep two watchlists apart on the same search, or to start a fresh history. Reusing a name for a different search replaces its history." }, "vehicle_type": { "title": "Vehicle type", "enum": [ "cars", "bikes-atvs", "rvs", "snowmobiles", "trailers", "boats", "heavy-equipment", "watercraft", "farm-equipment", "commercial-trucks" ], "type": "string", "description": "Which part of AutoTrader to search. Every other filter applies within it.", "default": "cars" }, "makes": { "title": "Makes", "type": "array", "description": "Vehicle makes to include. Leave empty for all makes.", "items": { "type": "string", "enum": [ "AC", "Acadian", "Acura", "Alfa Romeo", "Allard", "Alpina", "Alvis", "AM General", "AMC", "American Bantam", "Amphicar", "ASA", "Aston Martin", "Asuna", "Auburn", "Audi", "Aurora", "Austin", "Austin-Healey", "Bentley", "BMW", "BrightDrop", "Bugatti", "Buick", "Cadillac", "Chamonix", "Chevrolet", "Chrysler", "Citroen", "Clenet", "Cord", "Daewoo", "Daihatsu", "Datsun", "De Tomaso", "Dodge", "Eagle", "Excalibur", "Factory Five Racing", "Ferrari", "Fiat", "Fisker", "Ford", "Freightliner", "Genesis", "Geo", "GMC", "Hino", "Honda", "HUMMER", "Hyundai", "Ineos", "Infiniti", "International", "Isuzu", "Jaguar", "Jeep", "Jensen", "Karma", "Kia", "Lada", "Lamborghini", "Lancia", "Land Rover", "Lexus", "Lincoln", "Lordstown", "Lotus", "Lucid", "Maserati", "Maybach", "Mazda", "McLaren", "Mercedes-Benz", "Mercury", "Merkur", "MG", "MINI", "Mitsubishi", "Morgan", "MV-1", "Nissan", "Oldsmobile", "Panoz", "Peugeot", "Pininfarina", "Plymouth", "Polestar", "Pontiac", "Porsche", "RAM", "Rambler", "Renault", "Rivian", "Rolls-Royce", "Rover", "Saab", "Saleen", "Saturn", "Scion", "SEAT", "Shelby", "smart", "Spyker", "Sterling", "Studebaker", "Subaru", "Sunbeam", "Suzuki", "Tesla", "Toyota", "Triumph", "TVR", "Unspecified", "Vanderhall", "VinFast", "Volkswagen", "Volvo", "Willys", "Yugo" ], "enumTitles": [ "AC", "Acadian", "Acura", "Alfa Romeo", "Allard", "Alpina", "Alvis", "AM General", "AMC", "American Bantam", "Amphicar", "ASA", "Aston Martin", "Asuna", "Auburn", "Audi", "Aurora", "Austin", "Austin-Healey", "Bentley", "BMW", "BrightDrop", "Bugatti", "Buick", "Cadillac", "Chamonix", "Chevrolet", "Chrysler", "Citroen", "Clenet", "Cord", "Daewoo", "Daihatsu", "Datsun", "De Tomaso", "Dodge", "Eagle", "Excalibur", "Factory Five Racing", "Ferrari", "Fiat", "Fisker", "Ford", "Freightliner", "Genesis", "Geo", "GMC", "Hino", "Honda", "HUMMER", "Hyundai", "Ineos", "Infiniti", "International", "Isuzu", "Jaguar", "Jeep", "Jensen", "Karma", "Kia", "Lada", "Lamborghini", "Lancia", "Land Rover", "Lexus", "Lincoln", "Lordstown", "Lotus", "Lucid", "Maserati", "Maybach", "Mazda", "McLaren", "Mercedes-Benz", "Mercury", "Merkur", "MG", "MINI", "Mitsubishi", "Morgan", "MV-1", "Nissan", "Oldsmobile", "Panoz", "Peugeot", "Pininfarina", "Plymouth", "Polestar", "Pontiac", "Porsche", "RAM", "Rambler", "Renault", "Rivian", "Rolls-Royce", "Rover", "Saab", "Saleen", "Saturn", "Scion", "SEAT", "Shelby", "smart", "Spyker", "Sterling", "Studebaker", "Subaru", "Sunbeam", "Suzuki", "Tesla", "Toyota", "Triumph", "TVR", "Unspecified", "Vanderhall", "VinFast", "Volkswagen", "Volvo", "Willys", "Yugo" ] } }, "models": { "title": "Models", "type": "array", "description": "Model names to narrow the makes above, for example \"A4\" or \"CR-V\". Spelling is forgiving (case, spaces and hyphens are ignored). Requires at least one make, since model names are only unique within a make. A name that matches no model is reported in the log and ignored.", "items": { "type": "string" } }, "conditions": { "title": "Condition", "type": "array", "description": "New, used, or one of AutoTrader's other offer types. Leave empty for all.", "items": { "type": "string", "enum": [ "new", "used", "employees-car", "antique-classic", "demonstration", "pre-registered" ], "enumTitles": [ "New", "Used", "Employee's car", "Antique / classic", "Demonstration", "Pre-registered" ] } }, "seller_type": { "title": "Seller type", "type": "array", "description": "Dealer or private seller. Leave empty for both.", "items": { "type": "string", "enum": [ "dealer", "private" ], "enumTitles": [ "Dealer", "Private" ] } }, "price_from": { "title": "Price from", "minimum": 0, "type": "integer", "description": "Lowest asking price, in CAD." }, "price_to": { "title": "Price to", "minimum": 0, "type": "integer", "description": "Highest asking price, in CAD." }, "model_year_from": { "title": "Model year from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest model year." }, "model_year_to": { "title": "Model year to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest model year." }, "mileage_from_km": { "title": "Mileage from", "minimum": 0, "type": "integer", "description": "Lowest odometer reading, in kilometres." }, "mileage_to_km": { "title": "Mileage to", "minimum": 0, "type": "integer", "description": "Highest odometer reading, in kilometres." }, "body_types": { "title": "Body types", "type": "array", "description": "Body styles to include. Leave empty for all.", "items": { "type": "string", "enum": [ "hatchback", "convertible", "coupe", "wagon", "sedan", "minivan", "suv", "pickup-truck", "other" ], "enumTitles": [ "Hatchback", "Convertible", "Coupe", "Wagon", "Sedan", "Minivan", "SUV", "Pick-up truck", "Other" ] } }, "fuel_types": { "title": "Fuel types", "type": "array", "description": "Fuel or powertrain types to include. Leave empty for all.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "electric", "hybrid", "flex-fuel", "natural-gas", "propane-lpg", "other" ], "enumTitles": [ "Gasoline", "Diesel", "Electric", "Hybrid", "Flex fuel", "Natural gas", "Propane (LPG)", "Other" ] } }, "transmission": { "title": "Transmission", "type": "array", "description": "Automatic or manual. Leave empty for both.", "items": { "type": "string", "enum": [ "automatic", "manual" ], "enumTitles": [ "Automatic", "Manual" ] } }, "cylinders": { "title": "Cylinders", "type": "array", "description": "Engine cylinder counts to include.", "items": { "type": "string", "enum": [ "3", "4", "6", "8", "10plus" ], "enumTitles": [ "3", "4", "6", "8", "10 or more" ] } }, "power_from": { "title": "Power from", "minimum": 0, "type": "integer", "description": "Minimum engine power, in the unit selected below." }, "power_to": { "title": "Power to", "minimum": 0, "type": "integer", "description": "Maximum engine power, in the unit selected below." }, "power_unit": { "title": "Power unit", "enum": [ "hp", "kw" ], "type": "string", "description": "Unit for the power range above. Only used when a power range is set.", "default": "hp" }, "doors_from": { "title": "Doors from", "minimum": 1, "maximum": 10, "type": "integer", "description": "Minimum number of doors." }, "doors_to": { "title": "Doors to", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of doors." }, "seats_from": { "title": "Seats from", "minimum": 1, "maximum": 20, "type": "integer", "description": "Minimum number of seats." }, "seats_to": { "title": "Seats to", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of seats." }, "exterior_colors": { "title": "Exterior colours", "type": "array", "description": "Exterior colours to include. Leave empty for all.", "items": { "type": "string", "enum": [ "beige", "blue", "brown", "bronze", "yellow", "grey", "green", "red", "black", "silver", "violet", "white", "orange", "gold" ], "enumTitles": [ "Beige", "Blue", "Brown", "Bronze", "Yellow", "Grey", "Green", "Red", "Black", "Silver", "Violet", "White", "Orange", "Gold" ] } }, "interior_colors": { "title": "Interior colours", "type": "array", "description": "Interior colours to include. Leave empty for all.", "items": { "type": "string", "enum": [ "beige", "black", "grey", "brown", "other", "blue", "red", "green", "yellow", "orange", "white" ], "enumTitles": [ "Beige", "Black", "Grey", "Brown", "Other", "Blue", "Red", "Green", "Yellow", "Orange", "White" ] } }, "upholstery": { "title": "Upholstery", "type": "array", "description": "Seat material. Leave empty for all.", "items": { "type": "string", "enum": [ "alcantara", "cloth", "full-leather", "part-leather", "velour", "other" ], "enumTitles": [ "Alcantara", "Cloth", "Full leather", "Part leather", "Velour", "Other" ] } }, "equipment": { "title": "Features and equipment", "type": "array", "description": "Only listings that have ALL of the selected features. Dealers fill these in by hand, so picking several at once narrows results sharply.", "items": { "type": "string", "enum": [ "abs", "driver-airbag", "passenger-airbag", "sunroof-moonroof", "air-conditioning", "leather-seats", "power-windows", "alloy-wheels", "power-seats", "alarm", "fog-lights", "trailer-hitch", "navigation-system", "roof-rack", "automatic-climate-control", "traction-control", "side-airbag", "heated-seats", "guarantee", "cruise-control", "park-distance-control", "electronic-stability-control", "full-service-history", "panoramic-roof", "tinted-windows", "non-smoking-vehicle", "start-stop-system", "daytime-running-lights", "bluetooth", "heads-up-display", "rain-sensing-wipers", "front-parking-sensors", "rear-parking-sensors", "backup-camera", "adaptive-cruise-control", "heated-steering-wheel", "led-headlights", "lumbar-support", "air-suspension", "emergency-brake-assist", "tire-pressure-monitor", "remote-keyless-entry", "cooled-seats", "sound-system", "lane-departure-warning", "blind-spot-monitor", "360-camera", "apple-carplay", "wireless-charging", "digital-cockpit", "front-collision-warning" ], "enumTitles": [ "Anti-lock brakes (ABS)", "Driver airbag", "Passenger airbag", "Sun / moonroof", "Air conditioning", "Leather seats", "Power windows", "Alloy wheels", "Power seats", "Alarm", "Fog lights", "Trailer hitch", "Navigation system", "Roof rack", "Automatic climate control", "Traction control", "Side airbag", "Heated seats", "Guarantee", "Cruise control", "Park distance control", "Electronic stability control", "Full service history", "Panoramic roof", "Tinted windows", "Non-smoking vehicle", "Start-stop system", "Daytime running lights", "Bluetooth", "Heads-up display", "Rain-sensing wipers", "Front parking sensors", "Rear parking sensors", "Back-up camera", "Adaptive cruise control", "Heated steering wheel", "LED headlights", "Lumbar support", "Air suspension", "Emergency brake assist", "Tire pressure monitor", "Remote keyless entry", "Cooled seats", "Sound system", "Lane departure warning", "Blind spot monitor", "360° camera", "Apple CarPlay", "Wireless charging", "Digital cockpit", "Front collision warning" ] } }, "postal_code": { "title": "Postal code or city", "type": "string", "description": "Search around this location. Use a Canadian postal code on its own (\"M5V 3L9\", \"M5V\") or a place name with or without a province (\"Prince George\", \"Prince George, BC\"). Do not put a province after a postal code: \"V2N0A3, BC\" is the one format AutoTrader's search cannot read. Required for the search radius below to apply." }, "radius_km": { "title": "Search radius", "enum": [ "10", "20", "50", "100", "150", "200", "250", "300", "400" ], "type": "string", "description": "How far from the location above to search. Leave empty and AutoTrader applies its own default of 100 km, so a location always limits the search whether or not you pick a radius. Ignored when no location is set." }, "listed_within_days": { "title": "Listed within the last", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only listings posted within this many days." }, "include_damaged": { "title": "Include damaged vehicles", "type": "boolean", "description": "Off by default, matching the site: damaged and salvage listings are excluded.", "default": false }, "sort_by": { "title": "Sort results by", "enum": [ "standard", "price", "model_year", "mileage", "age", "power", "make", "distance" ], "type": "string", "description": "Order results are returned in. Matters when a search hits AutoTrader's 4,000-listing ceiling, since it decides which 4,000 you get.", "default": "standard" }, "sort_descending": { "title": "Sort descending", "type": "boolean", "description": "Reverse the sort order: highest price, newest year, most kilometres first.", "default": false }, "start_page": { "title": "Start page (100 listings per page)", "minimum": 1, "type": "integer", "description": "Page number to start from (1-indexed). Leave empty to start at page 1. NOTE: this Actor reads 100 listings per page, while autotrader.ca shows 20 by default, so page 3 here covers the same vehicles as pages 11 to 15 on the site." }, "end_page": { "title": "End page", "minimum": 1, "type": "integer", "description": "Page number to stop at (1-indexed, inclusive). Leave empty to scrape all pages." } } }, "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 } } } } } } } } } }