# T\&T Supermarket Scraper API - Canada (`sunny_eternity/tnt-grocery-scraper`) Actor Scrape T\&T Supermarket grocery prices and product data — Canada's largest Asian grocery chain. Extract names, prices, unit pricing, package sizes, images, and URLs across BC, Alberta, Ontario & Quebec. Export as JSON, CSV, or Excel for price monitoring & comparison apps. - **URL**: https://apify.com/sunny\_eternity/tnt-grocery-scraper.md - **Developed by:** [JChaw](https://apify.com/sunny_eternity) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## T&T Supermarket Grocery Price Scraper API Extract grocery prices and product data from [T&T Supermarket](https://www.tntsupermarket.com) — Canada's largest Asian grocery chain — including product names, current prices, unit prices, package sizes, product images, and product URLs. This Actor is built for Asian grocery price monitoring, retail analytics, grocery price comparison apps, food inflation research, and automated Canadian grocery data pipelines. Use it to collect structured T&T product data by category or search query, then export results as JSON, CSV, Excel, or through the Apify API. ### 🔗 Related Actors Pair this with our other Canadian grocery scrapers for full coverage: - **[Loblaws Grocery Scraper](https://apify.com/sunny_eternity/loblaws-grocery-scraper)** — Canadian national coverage for Real Canadian Superstore, No Frills, and Loblaws. - **[Save-On-Foods & PriceSmart Grocery Scraper](https://apify.com/sunny_eternity/save-on-foods-pricesmart-scraper)** — Western Canada coverage for Save-On-Foods and PriceSmart Foods. ### Who is this for? - Developers building grocery price comparison apps - Retail analysts monitoring Canadian Asian grocery prices - CPG brands tracking T&T pricing and availability - Researchers studying food inflation and grocery affordability - Data teams building Canadian grocery product databases - Indie hackers building shopping, deal, or price alert tools ### Features - 🚀 **Fast & reliable**: No slow browser automation, no Puppeteer — get clean structured data in seconds - 📊 **Complete product data**: Names, prices, unit prices, package sizes, images, URLs, and product IDs - 🔍 **Category & search**: Scrape full departments or run keyword searches ("milk", "soy sauce") — combine both in one run - 📍 **Location labels**: Tag output records with the nearest T&T store by postal code - 📁 **Multiple export formats**: Download as JSON, CSV, or Excel - 🔌 **Integrations**: Connect with Zapier, Make, Google Sheets, webhooks, and the Apify API ### What data does the T&T scraper extract? | 🏷️ Product name | 💲 Price (CAD) | | ----------------------------------- | ------------------------------------- | | 📦 Package size (when derivable) | 📊 Unit price (e.g., 'per lb') | | 🖼️ Product image URL | 🔗 Product page URL | | 🆔 SKU | 📍 Nearest store label | | ⚖️ Selling type (by weight/by unit) | 🏬 Store location name | ### ⬇️ Input | Field | Type | Required | Description | | --------------- | -------- | -------- | ----------------------------------------------------------------- | | `categories` | string[] | ✳️ | T&T categories to scrape (multi-select dropdown) | | `categoryUrls` | string[] | ✳️ | Custom numeric T&T category IDs not in the dropdown | | `search_terms` | string[] | ✳️ | Free-text search queries (e.g., `milk`, `soy sauce`) | | `postal_code` | string | ✳️ | Canadian postal code — labels output records with nearest store | | `locationId` | string | ✳️ | T&T store code (e.g., `MGFS`); takes priority over `postal_code` | > ✳️ At least one of `categories`, `categoryUrls`, or `search_terms` must be provided. > ✳️ At least one of `postal_code` or `locationId` must be provided. #### Example inputs **Single category:** ```json { "categories": ["produce/fruits"], "postal_code": "V5X 0C4" } ```` **Multiple categories:** ```json { "categories": ["dairy-eggs", "bakery", "frozen/foods"], "locationId": "UVFS" } ``` **Keyword search:** ```json { "search_terms": ["milk", "soy sauce", "organic eggs"], "postal_code": "V5X 0C4" } ``` **Category + search combined:** ```json { "categories": ["produce/fruits"], "search_terms": ["mango"], "locationId": "MGFS" } ``` **Custom category ID (advanced):** ```json { "categoryUrls": ["2877"], "postal_code": "V6M 2P8" } ``` ### ⬆️ Output Results are stored in a dataset accessible from the Output or Storage tab. Export as JSON, CSV, or Excel. #### JSON output example ```json { "store": "T&T Supermarket", "name": "Seedless Green Grape (~2.5lb)", "price": "4.99", "unit_price": "per lb", "image_url": "https://www.tntsupermarket.com/media/catalog/product/...", "product_url": "https://www.tntsupermarket.com/05026801-seedless-green-grape.html", "product_id": "05026801", "location": "MGFS", "location_name": "Marine Gateway", "category": "produce/fruits", "selling_type": "by_weight", "package_size": null, "comparable_unit_price": null, "was_price": null, "is_on_sale": false, "multi_buy_deal": null } ``` ### 🏪 Supported stores The actor calls T\&T's live pickup-locations API at runtime, so it resolves to whatever stores T\&T currently operates. Pass any Canadian postal code via `postal_code` and the actor picks the nearest store automatically. To target a specific store, pass its T\&T code via `locationId`. Common codes (BC / AB / ON / QC): | Code | Store | City | | ------ | -------------------------- | --------------------- | | `MGFS` | Marine Gateway | Vancouver, BC | | `LDFS` | Lansdowne | Richmond, BC | | `MTFS` | Metrotown | Burnaby, BC | | `LHFS` | Lougheed | Coquitlam, BC | | `CCFS` | Central City | Surrey, BC | | `DFFS` | Deerfoot | Calgary, AB | | `HHFS` | Harvest Hills | Calgary, AB | | `NEFS` | Northtown Edmonton | Edmonton, AB | | `SEFS` | South Edmonton | Edmonton, AB | | `WYFS` | Weldrick | Richmond Hill, ON | | `PRFS` | Promenade | Thornhill, ON | | `UVFS` | Unionville | Markham, ON | | `CPFS` | Central Parkway | Mississauga, ON | | `WLFS` | Waterloo | Waterloo, ON | | `LOFS` | London | London, ON | | `SLFS` | St. Croix | Montreal, QC | | `BRFS` | Brossard | Brossard, QC | ### ❓ FAQ #### Are sales and promotional prices included? Not in this version — `was_price` is always `null` and `is_on_sale` is always `false`. We may add promotional field support in a future release. #### Does the scraper return store-specific prices? T\&T serves a unified product catalog across all stores. The `locationId` and `postal_code` inputs label each output record with the nearest physical store, but the product data is the same across the chain. #### Is there an official T\&T API? T\&T does not offer a public API for product or pricing data. This actor gives you a reliable, structured alternative — fresh grocery data without the maintenance overhead of building your own scraper. #### Is it legal to scrape T\&T? Scraping publicly available product and price information is generally legal, but you are responsible for complying with T\&T's terms of service and any applicable laws in your jurisdiction. Use the data responsibly and avoid excessive request volume. #### How much does it cost to run? The actor runs on Apify's pay-per-usage model. Small scrapes (a few categories) typically fit within Apify's free tier credits. Larger full-store scrapes scale with the number of products and API calls. #### Which provinces does T\&T cover? T\&T Supermarket operates in British Columbia, Alberta, and Ontario. Postal code resolution works for major metro areas in those provinces. #### Can I integrate the scraper with other tools? Yes! Use Apify integrations to connect with Zapier, Make, Google Sheets, Airbyte, and more. You can also trigger runs via webhooks or the Apify API and export scraped data as JSON, CSV, or Excel. #### Can I schedule recurring scrapes? Yes — use Apify's built-in scheduler to run the actor daily, weekly, or on any cron schedule. This is ideal for tracking grocery price history over time. ### 📝 Your feedback We're always working on improving the performance of our Actors. If you've got any technical feedback for the T\&T Grocery Scraper or found a bug, please create an issue on the Actor's Issues tab. # Actor input Schema ## `categories` (type: `array`): Select one or more T\&T categories to scrape. Each scrapes all products in that category, paginating automatically. ## `categoryUrls` (type: `array`): Optional: provide raw numeric T\&T category IDs not listed above. Find IDs in the tntsupermarket.com URL: ?cat={ID}. ## `search_terms` (type: `array`): Free-text search queries (e.g., 'milk', 'soy sauce', 'organic eggs'). Each term is scraped separately and results are tagged with category 'search:'. ## `postal_code` (type: `string`): Canadian postal code (e.g., 'V5X 0C4'). Resolves to the nearest T\&T store via T\&T's pickup-locations API. locationId takes priority if both provided. ## `locationId` (type: `string`): Optional T\&T store code (e.g., 'MGFS' = Marine Gateway, 'UVFS' = Unionville, 'SLFS' = St. Croix). Resolved against T\&T's live store directory. Note: T\&T's catalog API serves a unified product list regardless of selected store, so this is purely a display label. ## Actor input object example ```json { "postal_code": "V5X 0C4" } ``` # Actor output Schema ## `products` (type: `string`): Complete dataset of scraped products including names, prices, images, unit pricing, and package sizes from the specified T\&T category # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("sunny_eternity/tnt-grocery-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("sunny_eternity/tnt-grocery-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call sunny_eternity/tnt-grocery-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sunny_eternity/tnt-grocery-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "T&T Supermarket Scraper API - Canada", "description": "Scrape T&T Supermarket grocery prices and product data — Canada's largest Asian grocery chain. Extract names, prices, unit pricing, package sizes, images, and URLs across BC, Alberta, Ontario & Quebec. Export as JSON, CSV, or Excel for price monitoring & comparison apps.", "version": "1.0", "x-build-id": "BIK6RIkYdxM58bt0R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sunny_eternity~tnt-grocery-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sunny_eternity-tnt-grocery-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~tnt-grocery-scraper/runs": { "post": { "operationId": "runs-sync-sunny_eternity-tnt-grocery-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~tnt-grocery-scraper/run-sync": { "post": { "operationId": "run-sync-sunny_eternity-tnt-grocery-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": { "categories": { "title": "Categories", "type": "array", "description": "Select one or more T&T categories to scrape. Each scrapes all products in that category, paginating automatically.", "items": { "type": "string", "enum": [ "deli-prepared-foods", "bakery", "produce/fruits", "produce/vegetables", "meat-seafood/meat", "meat-seafood/seafood", "dairy-eggs", "frozen/foods", "frozen/desserts", "frozen/seafood", "snacks-candy/snacks", "snacks-candy/candy", "pantry/canned-dry", "pantry/condiments", "beverages" ], "enumTitles": [ "📁 Deli & Prepared Foods", "📁 Bakery", "└ Produce — Fruits", "└ Produce — Vegetables", "└ Meat & Seafood — Meat", "└ Meat & Seafood — Seafood", "📁 Dairy & Eggs", "└ Frozen — Foods", "└ Frozen — Desserts", "└ Frozen — Seafood", "└ Snacks & Candy — Snacks", "└ Snacks & Candy — Candy", "└ Pantry — Canned & Dry", "└ Pantry — Condiments", "📁 Beverages" ] } }, "categoryUrls": { "title": "Custom Category IDs (optional)", "type": "array", "description": "Optional: provide raw numeric T&T category IDs not listed above. Find IDs in the tntsupermarket.com URL: ?cat={ID}.", "items": { "type": "string" } }, "search_terms": { "title": "Search Terms (optional)", "type": "array", "description": "Free-text search queries (e.g., 'milk', 'soy sauce', 'organic eggs'). Each term is scraped separately and results are tagged with category 'search:'.", "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., 'V5X 0C4'). Resolves to the nearest T&T store via T&T's pickup-locations API. locationId takes priority if both provided.", "default": "V5X 0C4" }, "locationId": { "title": "Store Location Code", "type": "string", "description": "Optional T&T store code (e.g., 'MGFS' = Marine Gateway, 'UVFS' = Unionville, 'SLFS' = St. Croix). Resolved against T&T's live store directory. Note: T&T's catalog API serves a unified product list regardless of selected store, so this is purely a display label." } } }, "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 } } } } } } } } } } ```