{ "openapi": "3.0.1", "info": { "title": "Autotrader Canada Per results", "description": "Our autotrader.ca scraper effortlessly gathers URLs from all pages and extracts detailed information from each listing cars.", "version": "0.0", "x-build-id": "djb7egEgGj1WNHRGs" }, "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. 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." }, "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 } } }, "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 } } } } } } } } } }