{ "openapi": "3.0.1", "info": { "title": "Save-On-Foods & PriceSmart Foods Scraper API - Canada", "description": "Extract product data from Pattison Food Group grocery stores (Save-On-Foods, PriceSmart Foods), including prices, images, package sizes, and normalized unit pricing. Export data in JSON/CSV, run via API, or schedule regular price monitoring.", "version": "1.0", "x-build-id": "ftsfttz0tdtLsX5IU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sunny_eternity~save-on-foods-pricesmart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sunny_eternity-save-on-foods-pricesmart-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/sunny_eternity~save-on-foods-pricesmart-scraper/runs": { "post": { "operationId": "runs-sync-sunny_eternity-save-on-foods-pricesmart-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/sunny_eternity~save-on-foods-pricesmart-scraper/run-sync": { "post": { "operationId": "run-sync-sunny_eternity-save-on-foods-pricesmart-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", "required": [ "banner" ], "properties": { "banner": { "title": "Store Banner", "enum": [ "saveonfoods", "pricesmart" ], "type": "string", "description": "Which Pattison Food Group banner to scrape", "default": "saveonfoods" }, "categories": { "title": "Categories", "type": "array", "description": "Select departments (📁) or specific subcategories (└). Selecting a department scrapes all products in that department.", "items": { "type": "string", "enum": [ "fruits-vegetables", "fruits-vegetables/fresh-fruit", "fruits-vegetables/fresh-vegetables", "fruits-vegetables/fresh-juice-smoothies", "fruits-vegetables/fresh-noodle-tofu-soy-products", "fruits-vegetables/salad-kits-greens-essentials", "fruits-vegetables/dried-snack-fruit-nuts", "fruits-vegetables/dressing-dips", "fruits-vegetables/trays-baskets-platters", "dairy-eggs", "dairy-eggs/butter-margarine", "dairy-eggs/cheese", "dairy-eggs/chilled-juice-drinks", "dairy-eggs/dough-products", "dairy-eggs/eggs-substitutes", "dairy-eggs/milk-creams", "dairy-eggs/milk-substitutes", "dairy-eggs/pudding-desserts", "dairy-eggs/sour-cream-dips", "dairy-eggs/yogurt", "meat-seafood", "meat-seafood/bacon", "meat-seafood/beef-veal", "meat-seafood/chicken-turkey", "meat-seafood/fish", "meat-seafood/frozen-meat", "meat-seafood/frozen-seafood", "meat-seafood/game-specialty-meats", "meat-seafood/hot-dogs-sausages", "meat-seafood/lamb", "meat-seafood/meat-alternatives", "meat-seafood/pork-ham", "meat-seafood/shrimp-shell-fish", "meat-seafood/smoked-cured-fish", "deli-ready-made-meals", "deli-ready-made-meals/cheese", "deli-ready-made-meals/dips-spreads-olives", "deli-ready-made-meals/meat", "deli-ready-made-meals/party-platters", "deli-ready-made-meals/quick-ready-meals-sides", "bakery", "bakery/bagels-english-muffins", "bakery/breads", "bakery/cakes", "bakery/dessert-pastries", "bakery/frozen-bakery", "bakery/pies-tarts", "bakery/pitas-flatbread-wraps", "bakery/pizza-crust-crumbs", "bakery/rolls-buns", "bakery/roti-naan-breads", "pantry", "pantry/baking-goods", "pantry/breakfast", "pantry/beverages", "pantry/bulk", "pantry/candy", "pantry/canned-packaged", "pantry/condiments-toppings", "pantry/herbs-spices-seasonings", "pantry/marinates-sauces", "pantry/oils-vinegars", "pantry/pasta-sauces-grains", "pantry/snacks", "frozen", "frozen/frozen-appetizers-snacks", "frozen/frozen-bakery", "frozen/frozen-beverages-ice", "frozen/frozen-breakfast", "frozen/frozen-fruit", "frozen/frozen-meals-sides", "frozen/frozen-meat", "frozen/frozen-pizza", "frozen/frozen-seafood", "frozen/frozen-vegetables", "frozen/ice-cream-desserts", "international-foods", "international-foods/asian", "international-foods/european", "international-foods/indian-middle-eastern", "international-foods/latin-mexican", "international-foods/mediterranean", "plant-based-non-dairy", "plant-based-non-dairy/egg-alternatives", "plant-based-non-dairy/meat-alternatives", "plant-based-non-dairy/non-dairy-beverages", "plant-based-non-dairy/non-dairy-cheese", "plant-based-non-dairy/non-dairy-creamers", "plant-based-non-dairy/non-dairy-frozen-dessert", "plant-based-non-dairy/non-dairy-spreads-condiments", "plant-based-non-dairy/non-dairy-yogurt", "plant-based-non-dairy/tofu", "health-beauty", "health-beauty/beauty", "health-beauty/diet-nutrition", "health-beauty/medicine-health", "health-beauty/personal-care", "cleaning-paper-home", "cleaning-paper-home/air-freshners-candles", "cleaning-paper-home/bakeware-baking-tools", "cleaning-paper-home/cleaning-supplies", "cleaning-paper-home/household-essentials", "cleaning-paper-home/kitchen-dining", "cleaning-paper-home/laundry-essentials", "cleaning-paper-home/outdoor-living", "cleaning-paper-home/paper-products", "cleaning-paper-home/plastic-foil-storage", "pet-care", "pet-care/cat", "pet-care/dog", "pet-care/pet-grooming", "pet-care/small-animal-fish-bird", "baby-care", "baby-care/baby-accessories-toys", "baby-care/baby-bath-skincare", "baby-care/baby-food", "baby-care/baby-formula", "baby-care/baby-health-wellness", "baby-care/baby-wipes", "baby-care/diapers", "floral-and-garden", "floral-and-garden/bouquets", "floral-and-garden/ferns-outdoor-floral", "floral-and-garden/potted-plants", "floral-and-garden/roses" ], "enumTitles": [ "📁 Fruits & Vegetables", " └ Fresh Fruit", " └ Fresh Vegetables", " └ Fresh Juice & Smoothies", " └ Fresh Noodle, Tofu & Soy Products", " └ Salad Kits, Greens & Essentials", " └ Dried, Snack Fruit & Nuts", " └ Dressing & Dips", " └ Trays, Baskets & Platters", "📁 Dairy & Eggs", " └ Butter & Margarine", " └ Cheese", " └ Chilled Juice & Drinks", " └ Dough Products", " └ Eggs & Substitutes", " └ Milk & Creams", " └ Milk Substitutes", " └ Pudding & Desserts", " └ Sour Cream & Dips", " └ Yogurt", "📁 Meat & Seafood", " └ Bacon", " └ Beef & Veal", " └ Chicken & Turkey", " └ Fish", " └ Frozen Meat", " └ Frozen Seafood", " └ Game & Specialty Meats", " └ Hot Dogs & Sausages", " └ Lamb", " └ Meat Alternatives", " └ Pork & Ham", " └ Shrimp & Shell Fish", " └ Smoked & Cured Fish", "📁 Deli & Ready-Made Meals", " └ Cheese", " └ Dips, Spreads & Olives", " └ Meat", " └ Party Platters", " └ Quick & Ready Meals & Sides", "📁 Bakery", " └ Bagels & English Muffins", " └ Breads", " └ Cakes", " └ Dessert & Pastries", " └ Frozen Bakery", " └ Pies & Tarts", " └ Pitas, Flatbread & Wraps", " └ Pizza Crust & Crumbs", " └ Rolls & Buns", " └ Roti & Naan Breads", "📁 Pantry", " └ Baking Goods", " └ Breakfast", " └ Beverages", " └ Bulk", " └ Candy", " └ Canned & Packaged", " └ Condiments & Toppings", " └ Herbs, Spices & Seasonings", " └ Marinades & Sauces", " └ Oils & Vinegars", " └ Pasta, Sauces & Grains", " └ Snacks", "📁 Frozen", " └ Frozen Appetizers & Snacks", " └ Frozen Bakery", " └ Frozen Beverages & Ice", " └ Frozen Breakfast", " └ Frozen Fruit", " └ Frozen Meals & Sides", " └ Frozen Meat", " └ Frozen Pizza", " └ Frozen Seafood", " └ Frozen Vegetables", " └ Ice Cream & Desserts", "📁 International Foods", " └ Asian", " └ European", " └ Indian & Middle Eastern", " └ Latin & Mexican", " └ Mediterranean", "📁 Plant-Based & Non-Dairy", " └ Egg Alternatives", " └ Meat Alternatives", " └ Non-Dairy Beverages", " └ Non-Dairy Cheese", " └ Non-Dairy Creamers", " └ Non-Dairy Frozen Dessert", " └ Non-Dairy Spreads & Condiments", " └ Non-Dairy Yogurt", " └ Tofu", "📁 Health & Beauty", " └ Beauty", " └ Diet & Nutrition", " └ Medicine & Health", " └ Personal Care", "📁 Cleaning, Paper & Home", " └ Air Fresheners & Candles", " └ Bakeware & Baking Tools", " └ Cleaning Supplies", " └ Household Essentials", " └ Kitchen & Dining", " └ Laundry Essentials", " └ Outdoor Living", " └ Paper Products", " └ Plastic, Foil & Storage", "📁 Pet Care", " └ Cat", " └ Dog", " └ Pet Grooming", " └ Small Animal, Fish & Bird", "📁 Baby Care", " └ Baby Accessories & Toys", " └ Baby Bath & Skincare", " └ Baby Food", " └ Baby Formula", " └ Baby Health & Wellness", " └ Baby Wipes", " └ Diapers", "📁 Floral & Garden", " └ Bouquets", " └ Ferns & Outdoor Floral", " └ Potted Plants", " └ Roses" ] }, "default": [ "fruits-vegetables" ] }, "categoryUrls": { "title": "Custom Category IDs (optional)", "type": "array", "description": "Optional: provide raw numeric category IDs for subcategories not listed above (e.g., '30683' for Apples). Find IDs in the saveonfoods.com URL: /categories/{slug}-id-{ID}.", "items": { "type": "string" } }, "postal_code": { "title": "Postal Code", "pattern": "^[A-Za-z]\\d[A-Za-z]\\s?\\d[A-Za-z]\\d$", "type": "string", "description": "Canadian postal code (e.g., 'V6M 2P8') to auto-resolve the nearest store. locationId takes priority if both provided.", "default": "V6M 2P8" }, "locationId": { "title": "Store Location ID (rsid)", "type": "string", "description": "Optional store rsid (e.g., '1982' for Save-On Marine Drive Vancouver). Faster than postal_code — skips location lookup. Find it in the saveonfoods.com URL: /sm/planning/rsid/{ID}/." } } }, "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 } } } } } } } } } }