{ "openapi": "3.0.1", "info": { "title": "Autotrader.ca Listings Scraper", "description": "Scrape Autotrader.ca car listings by search URL or filters (make, model, price, year, mileage, location). Get price, specs, description, photos, dealer name and phone. Splits big searches past the 4,000 cap, newest first, optional full vehicle details.", "version": "0.0", "x-build-id": "3pRcXArqdGvCYGrxo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~autotrader-ca-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-autotrader-ca-listings-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/piotrv1001~autotrader-ca-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-autotrader-ca-listings-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/piotrv1001~autotrader-ca-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-autotrader-ca-listings-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste one or more Autotrader.ca search result URLs (set your filters on autotrader.ca, then copy the address bar), e.g. https://www.autotrader.ca/cars/honda/civic?offer=U. All filters, sorting and the page number in the URL are kept. When you add URLs, the filter fields below are ignored.", "items": { "type": "string" } }, "make": { "title": "Make", "type": "string", "description": "Car make, e.g. Toyota, Ford, Mercedes-Benz. Leave empty for all makes." }, "model": { "title": "Model", "type": "string", "description": "Car model, e.g. RAV4, F-150, Civic. Works together with Make." }, "condition": { "title": "Condition", "enum": [ "all", "new", "used" ], "type": "string", "description": "New cars, used cars, or both.", "default": "all" }, "priceMin": { "title": "Minimum price (CAD)", "minimum": 0, "type": "integer", "description": "Only cars priced at or above this amount." }, "priceMax": { "title": "Maximum price (CAD)", "minimum": 0, "type": "integer", "description": "Only cars priced at or below this amount." }, "yearMin": { "title": "Year from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest model year, e.g. 2018." }, "yearMax": { "title": "Year to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest model year, e.g. 2024." }, "mileageMax": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Only cars with at most this many kilometres." }, "sellerType": { "title": "Seller type", "enum": [ "all", "dealer", "private" ], "type": "string", "description": "Dealers, private sellers, or both.", "default": "all" }, "location": { "title": "Location (postal code or city)", "type": "string", "description": "Search around a Canadian postal code or city, e.g. M5V 2T6 or Calgary. Leave empty to search all of Canada." }, "radiusKm": { "title": "Search radius (km)", "minimum": 10, "maximum": 400, "type": "integer", "description": "Distance around the location (10-400 km). Used only when a location is set.", "default": 100 }, "sort": { "title": "Sort by", "enum": [ "newest", "relevance", "price_asc", "price_desc", "mileage_asc", "year_desc" ], "type": "string", "description": "Order of the results. Newest first is best for monitoring new listings.", "default": "newest" }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of cars to save across all searches. Set 0 for no limit. Searches with more than 4,000 results are split automatically, so large exports are complete.", "default": 50 }, "includeDetails": { "title": "Include full vehicle details", "type": "boolean", "description": "Open each car's listing page to add body type, colours, doors and seats, drivetrain, cylinders, horsepower, full equipment list, stock number, listing date and exact coordinates. Charged as an extra event per car.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy servers used for the requests. The default works well.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }