{ "openapi": "3.0.1", "info": { "title": "Canadian Tire Scraper — Store Stock, Prices, Sport Chek, Mark's", "description": "Canadian Tire, Sport Chek, Mark's & Party City products by keyword, category, URL or code: store-level CAD price, units on the shelf, warehouse stock, sale & clearance prices, per-size/colour stock, ratings, part numbers. Nearest stores to any postal code. No login.", "version": "0.1", "x-build-id": "M1FP8gTtkFt823qNz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~canadian-tire-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-canadian-tire-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/yugenox~canadian-tire-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-canadian-tire-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/yugenox~canadian-tire-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-canadian-tire-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": { "banners": { "title": "Stores (banners)", "type": "array", "description": "Which retailers to search. Search terms run on every banner you pick; start URLs always run on their own site. Canadian Tire is used when this is empty.", "items": { "type": "string", "enum": [ "CTR", "SC", "MKS", "PTY" ], "enumTitles": [ "Canadian Tire", "Sport Chek", "Mark's", "Party City" ] } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords, brands, part numbers or product codes, e.g. \"dewalt 20v\", \"winter tires\", \"hockey stick\", \"0546716P\". A product code returns that exact product.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Product, category, brand or search-results pages from canadiantire.ca, sportchek.ca, marks.com or partycity.ca. Filters in a category URL (e.g. ?x1=brand&q1=DEWALT) are kept.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "productCodes": { "title": "Product codes", "type": "array", "description": "Exact products by their code (the last part of the product URL), e.g. 0546716P (Canadian Tire), 80940585F (Sport Chek), 75983118F (Mark's). Returns every size/colour with its store price and stock.", "items": { "type": "string" } }, "fullCatalog": { "title": "Whole catalogue", "type": "boolean", "description": "Scrape every product the store carries (Canadian Tire: ~67,000 per store). Large result sets are split by category automatically. Set \"Max products per query\" to 0 to get everything.", "default": false }, "locations": { "title": "Near location", "type": "array", "description": "Price and stock come from the stores nearest to a postal code (\"M5V 2T6\"), city (\"Calgary\", \"Laval, QC\") or \"latitude,longitude\". Several locations = several stores.", "items": { "type": "string" } }, "nearestStores": { "title": "Stores per location", "minimum": 1, "maximum": 48, "type": "integer", "description": "How many of the nearest stores to scrape for each location and banner (1–48). Each store is a separate set of rows — useful for comparing stock across a city.", "default": 1 }, "storeIds": { "title": "Store IDs", "type": "array", "description": "Exact stores. Every row reports its store ID, e.g. 600 = Canadian Tire Toronto Eaton Centre. Prefix with the banner when you use several banners: \"CTR:600\", \"SC:401\", \"MKS:50\", \"PTY:820\".", "items": { "type": "string" } }, "inStockOnly": { "title": "In stock at the store only", "type": "boolean", "description": "Keep only products with units on the shelf at the selected store.", "default": false }, "deals": { "title": "Deals", "enum": [ "none", "sale", "clearance", "any" ], "type": "string", "description": "Only products on sale, on store clearance, or either.", "default": "none" }, "sort": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "newest", "rating", "bestseller" ], "type": "string", "description": "Result order (matters when you cap the number of products).", "default": "relevance" }, "includeVariants": { "title": "Sizes & colours (per-variant stock)", "type": "boolean", "description": "Add a variants list to multi-size products (tires, boots, clothing, hockey sticks): every size/colour with its own price, units in store and warehouse stock. One extra request per multi-size product.", "default": false }, "includeDetails": { "title": "Details (description, specs, category path, ratings)", "type": "boolean", "description": "Add the full description, specifications and category path to every product, and star ratings for Sport Chek and Mark's. One extra request per product.", "default": false }, "maxItemsPerQuery": { "title": "Max products per query", "minimum": 0, "type": "integer", "description": "Limit for each search term / URL / catalogue, per store. 0 = no limit.", "default": 1000 }, "maxItems": { "title": "Max products in total", "minimum": 0, "type": "integer", "description": "Stop the whole run after this many rows. 0 = no limit.", "default": 0 }, "language": { "title": "Language", "enum": [ "en", "fr" ], "type": "string", "description": "Product names and descriptions. French is available on Canadian Tire and Party City; Sport Chek and Mark's stay in English.", "default": "en" }, "exactKeywordSearch": { "title": "Exact keyword search", "type": "boolean", "description": "Some words open a category or brand page on the site (\"drill\" opens the Drills category). Off: scrape what the site shows. On: return every product whose text matches the words.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Parallel requests. The default is fast and gentle; raise it for very large runs.", "default": 20 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is required. The default datacenter pool works; the actor switches to residential (Canada) on its own if it gets blocked.", "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 } } } } } } } } } }