{ "openapi": "3.0.1", "info": { "title": "🚘Autotrader car data 🇨🇦(💰1/1000)", "description": "Canada's largest online marketplace for new and used cars, trucks, and SUVs. Search by city, by make and model, or hand it specific listing URLs, and get back clean, structured data for every matching vehicle: price, mileage, year, condition, seller details, photos, and more.", "version": "0.1", "x-build-id": "O1miTwxWGlQYzU3rf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jordan-byte~autotrader-car-data-1-1000/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jordan-byte-autotrader-car-data-1-1000", "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/jordan-byte~autotrader-car-data-1-1000/runs": { "post": { "operationId": "runs-sync-jordan-byte-autotrader-car-data-1-1000", "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/jordan-byte~autotrader-car-data-1-1000/run-sync": { "post": { "operationId": "run-sync-jordan-byte-autotrader-car-data-1-1000", "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": { "location": { "title": "Location", "enum": [ "Canada-wide (no location filter)", "Toronto, ON", "Ottawa, ON", "Mississauga, ON", "Brampton, ON", "Hamilton, ON", "London, ON", "Markham, ON", "Vaughan, ON", "Kitchener, ON", "Windsor, ON", "Richmond Hill, ON", "Oshawa, ON", "Barrie, ON", "Guelph, ON", "Kingston, ON", "Montreal, QC", "Quebec City, QC", "Laval, QC", "Gatineau, QC", "Longueuil, QC", "Sherbrooke, QC", "Saguenay, QC", "Vancouver, BC", "Surrey, BC", "Burnaby, BC", "Richmond, BC", "Abbotsford, BC", "Kelowna, BC", "Victoria, BC", "Coquitlam, BC", "Langley, BC", "Nanaimo, BC", "Calgary, AB", "Edmonton, AB", "Red Deer, AB", "Lethbridge, AB", "St. Albert, AB", "Winnipeg, MB", "Brandon, MB", "Saskatoon, SK", "Regina, SK", "Halifax, NS", "Moncton, NB", "Saint John, NB", "Fredericton, NB", "St. John's, NL", "Charlottetown, PE", "Whitehorse, YT", "Yellowknife, NT", "Iqaluit, NU" ], "type": "string", "description": "Search near a popular Canadian city, or choose \"Canada-wide\" to search the whole country. For a city not listed, use the custom location fields below instead.", "default": "Canada-wide (no location filter)" }, "radiusKm": { "title": "Search radius (km)", "minimum": 1, "maximum": 500, "type": "integer", "description": "How far from the selected location to include listings. Only used when Location is not \"Canada-wide\".", "default": 100 }, "make": { "title": "Make", "type": "string", "description": "Limit results to one make, e.g. \"Ford\", \"Toyota\", \"BMW\". Leave blank to scrape every make." }, "model": { "title": "Model", "type": "string", "description": "Limit results to one model within the chosen Make, e.g. \"Bronco Sport\". Ignored if Make is blank." }, "condition": { "title": "Condition", "enum": [ "all", "new", "used" ], "type": "string", "description": "Which listings to include.", "default": "all" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Configure the proxy servers used to fetch listings. Using Apify Proxy is recommended to keep the run reliable.", "default": { "useApifyProxy": true } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after collecting this many listings. Set to 0 to collect as many as possible - the Actor will automatically broaden its search (across makes and/or cities) to keep going past a single search's own result limit.", "default": 100 }, "listingUrls": { "title": "Specific listing URLs (optional)", "type": "array", "description": "Paste one or more AutoTrader.ca listing page URLs to scrape exactly those vehicles and skip searching entirely. When set, all search options above are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "scrapeListingDetails": { "title": "Scrape full listing details", "type": "boolean", "description": "Visit each listing's own page for complete data (full description, equipment/features list, seller details, vehicle history report link). Turning this off returns only the data shown on the search results page, which is faster and uses fewer requests.", "default": true }, "useCache": { "title": "Reuse cached results across runs", "type": "boolean", "description": "When enabled, listings already scraped in a previous run are reused instead of being fetched again, making repeat/monitoring runs faster and cheaper. Turn off to force a fully fresh scrape every time.", "default": true }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "priceAsc", "distance", "newestPosted", "yearNewest", "mileageLowest" ], "type": "string", "description": "Order in which matching listings are collected.", "default": "relevance" }, "detailConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many listing pages to fetch at the same time. Higher is faster but more likely to trigger rate limiting.", "default": 5 }, "customLocationLabel": { "title": "Custom location label", "type": "string", "description": "For a city not in the Location dropdown: a short label (e.g. \"Banff, AB\") plus the latitude/longitude below." }, "customLatitude": { "title": "Custom location latitude", "type": "number", "description": "Used together with Custom location label and longitude. Leave all three blank to use the Location dropdown instead." }, "customLongitude": { "title": "Custom location longitude", "type": "number", "description": "Used together with Custom location label and latitude. Leave all three blank to use the Location dropdown instead." } } }, "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 } } } } } } } } } }