# Briscoes Products Scraper (`parseforge/briscoes-products-scraper`) Actor Scrape Briscoes NZ products: images, prices, brands, ratings, stock, variants and GTIN codes. Export to CSV, Excel, JSON or XML in seconds. - **URL**: https://apify.com/parseforge/briscoes-products-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.72 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## 🏠 Briscoes Scraper > 🚀 **Export the whole Briscoes New Zealand catalog in seconds.** 23 fields per product, 690 shoppable categories, roughly 51,500 live SKUs, and up to 10,000 products per query. Briscoes is one of New Zealand's largest homeware, kitchenware and manchester retailers. This Actor reads the store's own public catalog service directly, so every row is the same data the website itself renders: the product image, the current NZD price, the was-price when an item is marked down, the brand, the stock status, the shopper rating, the GTIN-13 barcode and every colour or size variant with its own price. Coverage is the full public catalog: 690 categories across Kitchen, Bed and Bath, Bath, Dining, Living, Outdoor, Electrical, Cleaning and Laundry, Kids and Nursery, Travel, plus 284 brand pages and the Sale, Clearance and Online Only ranges. Across a 150 product sample, 100 percent carried a brand and a category breadcrumb, 98 percent a full marketing description, 72 percent a real product photo, 62 percent a GTIN-13 barcode and 11 percent a shopper rating with a review count. | 🎯 Target Audience | 💡 Primary Use Cases | | --- | --- | | 🛒 Retail and category buyers | Track competitor assortment, price points and markdown depth in the NZ homeware market | | 📊 Price intelligence teams | Build a daily NZD price feed with was-price and discount percentage per SKU | | 🏷️ Brands and distributors | Check how a brand's range is listed, priced and rated at one of NZ's biggest retailers | | 🤖 Data and AI teams | Feed a product catalog with images, barcodes, descriptions and variants into a model or search index | | 📦 Dropshippers and marketplaces | Import a clean product catalog with images, specs and stock status | | 🎓 Researchers and analysts | Study NZ retail price levels, assortment breadth and consumer ratings over time | ### 📋 What the Briscoes Scraper does Point it at Briscoes category pages, individual product pages, keyword searches, or any mix of the three. It reads the store's public catalog service, pages through the results, and writes one clean row per product. - 🖼 **Images first.** Primary image plus the whole gallery, straight from the Briscoes media CDN. - 💲 **Real NZD prices.** Current price, price range for multi-size products, was-price and the discount percentage. - 🏷 **Identity that survives a redesign.** SKU, GTIN-13 barcode, MPN and the canonical product URL. - ⭐ **Shopper ratings.** Rating value and review count for the products that carry published reviews. - 🎨 **Variants.** Each colour and size variant with its own SKU, price and stock status. - 🗂 **Category breadcrumbs.** The merchandising path the product sits under, for example `Kitchen > Kitchenware > Bakeware`. - 🔎 **Every filter the store itself offers.** Category, keyword, price range, sort order and an in-stock-only switch, all applied by the catalog service before a single row is billed. > 💡 **Why it matters:** New Zealand retail data is thin on the ground. Briscoes lists tens of thousands of SKUs with prices that move weekly, and there is no public feed. This Actor turns that storefront into a spreadsheet you can diff week over week. ### 🎬 Full Demo (🚧 Coming soon) A walkthrough video is on the way. Until then, the sample records below are real rows from a live run. ### 📊 Output Every row carries these 23 fields, in this order. | Field | Type | What it holds | | --- | --- | --- | | 🖼 `imageUrl` | string | Primary product image, or `N/A` when Briscoes has not published one yet | | 📌 `title` | string | Product name as merchandised | | 🔗 `url` | string | Canonical Briscoes product page | | 🏷 `sku` | string | Briscoes SKU, stable across slug changes | | ®️ `brand` | string | Brand name | | 💲 `price` | number | Current price in NZD (lowest variant price for multi-size products) | | 💹 `priceMax` | number | Highest variant price in NZD | | 🏷️ `wasPrice` | number or `N/A` | Pre-markdown price when the item is discounted | | 🔻 `discountPercent` | number | Markdown percentage, `0` when the item is at full price | | 💱 `currency` | string | Always `NZD` | | 📦 `availability` | string | `In Stock` or `Out of Stock` | | ⭐ `rating` | number or `Not Disclosed` | Average shopper rating out of 5 | | 🗣 `reviewCount` | number | Number of published reviews, `0` when none | | 🧩 `productType` | string | `Simple`, `Configurable`, `Bundle` or `Grouped` | | 🔢 `gtin13` | string | GTIN-13 barcode when published | | 🛠 `mpn` | string | Manufacturer part number when published | | 🚚 `shippingBand` | string | Briscoes shipping band, for example `Standard` | | 📝 `description` | string | Full marketing description and feature bullets | | 🗂 `categoryPath` | string | Merchandising breadcrumb | | 🎨 `variants` | array | Colour and size variants with SKU, price and stock status | | 🖼️ `imageGallery` | array | Every gallery image URL | | 🕒 `scrapedAt` | string | ISO timestamp of the row | | ❌ `error` | string or null | Populated only on a source error row | Three real records from a live run: ```json [ { "imageUrl": "https://www.briscoes.co.nz/media/catalog/product/1/0/1095486_00_default_1_5e03.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "title": "Ninja Foodi Dual Zone Air Fryer 2x3.8L AF300ANZ", "url": "https://www.briscoes.co.nz/product/1095486/ninja-foodi-dual-zone-air-fryer-2x3-8lt-af300anz/", "sku": "1095486", "brand": "Ninja", "price": 199.99, "priceMax": 199.99, "wasPrice": 349.99, "discountPercent": 42.86, "currency": "NZD", "availability": "In Stock", "rating": 4.8, "reviewCount": 882, "productType": "Simple", "gtin13": "622356239813", "mpn": "AF300ANZ", "shippingBand": "Standard", "description": "The Ninja Foodi Dual Zone Air Fryer offers a versatile cooking solution with two independent baskets, allowing you to prepare different foods simultaneously. Designed to accommodate family meals efficiently, it features advanced technology for precise and convenient cooking. 7.6 litre total capacity with two independent 3.8 litre baskets for cooking mains and sides at the same time DualZone™ Technology includes Smart Finish to synchronise cook times and Match Cook to copy settings across baskets Six customizable cooking programs: Air Fry, Air Broil, Roast, Bake, Reheat, and Dehydrate Wide temperature range from 40°C to 240°C for diverse cooking needs Easy-to-clean baskets and dishwasher-safe crisper plates Capable of cooking up to 1.8kg of french fries or chicken wings in one go 2 Year Warranty *Smart Finish intelligently syncs cook times so different foods finish together*", "categoryPath": "Electrical > Home Appliances", "variants": [], "imageGallery": [ "https://www.briscoes.co.nz/media/catalog/product/1/0/1095486_00_default_1_5e03.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/0/1095486_00_default_2_01d2.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/0/1095486_00_default_3_7c95.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/0/1095486_00_default_4_b198.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/0/1095486_00_lifestyle_1_851b.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=" ], "scrapedAt": "2026-09-08T06:46:31.300Z", "error": null }, { "imageUrl": "https://www.briscoes.co.nz/media/catalog/product/1/1/1132507_prod_default_1_b0f2.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "title": "Greenpan Bistro XXL Air Fryer 7.2L", "url": "https://www.briscoes.co.nz/product/1132507/greenpan-bistro-xxl-air-fryer-7-2l/", "sku": "1132507", "brand": "Greenpan", "price": 299.99, "priceMax": 299.99, "wasPrice": "N/A", "discountPercent": 0, "currency": "NZD", "availability": "In Stock", "rating": 4.4, "reviewCount": 14, "productType": "Configurable", "gtin13": "Not Disclosed", "mpn": "Not Disclosed", "shippingBand": "Standard", "description": "The Greenpan Bistro XXL Air Fryer 7.2L offers a spacious and efficient way to prepare healthier meals with less oil. Designed to cater for the whole family, it combines ease of use with a durable, PFAS-free ceramic non-stick coating for effortless cooking and cleaning. Generous 7.2L capacity ideal for 4-6 servings PFAS-free ceramic non-stick coating for healthier cooking 11 one-touch presets including air-fry, bake, roast, and grill Easy to clean, saving time in the kitchen Versatile for cooking meat, fish, vegetables, and even cake Available Online Only", "categoryPath": "Electrical > Home Appliances", "variants": [ { "sku": "1132507001", "name": "Greenpan Bistro XXL Air Fryer 7.2L", "price": 299.99, "availability": "In Stock" }, { "sku": "1132506001", "name": "Greenpan Bistro XXL Air Fryer 7.2L", "price": 299.99, "availability": "In Stock" }, { "sku": "1132505001", "name": "Greenpan Bistro XXL Air Fryer 7.2L", "price": 299.99, "availability": "In Stock" }, { "sku": "1132503001", "name": "Greenpan Bistro XXL Air Fryer 7.2L", "price": 299.99, "availability": "In Stock" }, { "sku": "1132504001", "name": "Greenpan Bistro XXL Air Fryer 7.2L", "price": 299.99, "availability": "In Stock" }, { "sku": "1132502001", "name": "Greenpan Bistro XXL Air Fryer 7.2L", "price": 299.99, "availability": "In Stock" } ], "imageGallery": [ "https://www.briscoes.co.nz/media/catalog/product/1/1/1132507_prod_default_1_b0f2.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/1/1132507_prod_default_2_497e.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/1/1132507_prod_default_3_0f8e.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/1/1132507_prod_default_4_3d09.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=", "https://www.briscoes.co.nz/media/catalog/product/1/1/1132507_prod_default_5_64cb.jpg?optimize=medium&bg-color=255,255,255&fit=bounds&height=&width=" ], "scrapedAt": "2026-09-08T06:46:42.809Z", "error": null }, { "imageUrl": "N/A", "title": "Breville ToastPro Toaster 4 Slice", "url": "https://www.briscoes.co.nz/product/1136333/breville-toastpro-toaster-4-slice/", "sku": "1136333", "brand": "Breville", "price": 229.99, "priceMax": 229.99, "wasPrice": "N/A", "discountPercent": 0, "currency": "NZD", "availability": "Out of Stock", "rating": "Not Disclosed", "reviewCount": 0, "productType": "Configurable", "gtin13": "Not Disclosed", "mpn": "Not Disclosed", "shippingBand": "Standard", "description": "The Breville ToastPro Toaster 4 Slice offers reliable and versatile toasting performance, suitable for a variety of bread types and thicknesses. Its design balances practicality with a sleek stainless steel finish, making it a functional and stylish addition to any kitchen. Lift & Look™ feature allows checking toast progress mid-cycle without interrupting the toasting process 'A Bit More'® function provides an additional toasting boost without restarting the cycle Dedicated settings for frozen bread and fruit bread ensure optimal toasting results High lift lever enables safe and easy removal of smaller slices Dimensions: 28.6 x 28.7 x 20.5 cm 12 months limited warranty Available Online Only", "categoryPath": "Electrical > Home Appliances", "variants": [ { "sku": "1136333002", "name": "Breville ToastPro Toaster 4 Slice", "price": 229.99, "availability": "Out of Stock" }, { "sku": "1136333001", "name": "Breville ToastPro Toaster 4 Slice", "price": 229.99, "availability": "Out of Stock" }, { "sku": "1136333003", "name": "Breville ToastPro Toaster 4 Slice", "price": 229.99, "availability": "Out of Stock" } ], "imageGallery": [], "scrapedAt": "2026-09-08T06:46:48.232Z", "error": null } ] ``` ### ✨ Why choose this Actor - ⚡ **Fast and cheap to run.** It talks to the store's own catalog service instead of rendering pages, so a thousand products cost a handful of requests and no browser memory. - 🎯 **690 verified categories.** The category picker is generated from the live Briscoes category tree, so there are no invented slugs to 404 on. - 🧾 **Barcodes and MPNs.** GTIN-13 and manufacturer part numbers let you join Briscoes rows to your own catalog or to another retailer's feed. - 🎨 **Variant level detail.** Multi-size and multi-colour products come back with each variant's SKU, price and stock status instead of a single blended price. - 🔁 **Slug-proof product URLs.** Product pages are resolved by SKU, so a URL you saved last month still returns the right product after Briscoes renames the slug. - 🧹 **No junk rows.** Delisted records that linger in the index with a zero price and a dead product page are dropped instead of shipped as empty rows. - 📤 **Any format.** Download as CSV, Excel, JSON or XML, or pull it through the Apify API. ### 📈 How it compares to alternatives | Approach | Setup | Fields | Coverage | Honest limits | | --- | --- | --- | --- | --- | | **This Actor** | Paste a category, keyword or URL | 23 per product | Full public catalog, roughly 51,500 SKUs | 10,000 results per query, so very large jobs are split by category | | Manual copy and paste | Hours per category | Whatever you retype | A page at a time | Stale the moment prices move | | A generic web crawler | Selector tuning, breaks on redesign | Whatever the HTML shows | Depends on the crawl | No barcodes, no variants, no was-price | | A headless browser scraper | Heavy, 4 GB per run | Similar | Similar | Slow and expensive for the same rows | | Briscoes affiliate or partner feeds | Approval process | Feed dependent | Partner catalog only | Not open to the public | ### 🚀 How to use 1. **Create a free Apify account.** New accounts get $5 in free credit: [sign up here](https://console.apify.com/sign-up?fpr=vmoqkp). 2. **Open the Actor** and pick your sources. Choose categories from the dropdown, type keywords into Search Terms, or paste Briscoes URLs into Start URLs. Any combination works and results are spread evenly across them. 3. **Set Max Items.** Free accounts preview 10 items. Paid accounts can go to 1,000,000. 4. **Narrow it down (optional).** Set a minimum or maximum NZD price, choose a sort order, or switch off out of stock products. 5. **Run it.** A thousand products take about a minute. 6. **Export.** Download CSV, Excel, JSON or XML from the dataset tab, or fetch it from the Apify API. ### 💼 Business use cases #### 🛒 Competitive price monitoring Run the Kitchen, Bed and Bath and Electrical categories every morning and diff `price`, `wasPrice` and `discountPercent` by SKU. You get markdown depth and timing for one of New Zealand's largest homeware chains without a partner agreement. #### 🏷️ Brand and distributor audits Filter to a brand's category page and check that every model is listed, priced correctly and in stock. `gtin13` and `mpn` let you match Briscoes rows against your own ERP export line by line. #### 📦 Assortment and gap analysis Pull two categories side by side and compare breadth, price bands and average rating. `categoryPath` gives you the retailer's own taxonomy, which is usually more useful than your internal one for merchandising decisions. #### 🤖 Product data enrichment Feed `title`, `description`, `imageGallery` and `variants` into a search index, a recommendation model or a marketplace listing. The description field carries the full feature bullet list, not a truncated snippet. ### 🔌 Automating Briscoes Scraper - **Make** and **Zapier**: trigger a run on a schedule and push new rows into Sheets, Airtable or Notion. - **Slack**: post an alert when `discountPercent` crosses a threshold on a watched SKU. - **Airbyte**: sync the dataset into Snowflake, BigQuery or Postgres for time series analysis. - **GitHub Actions**: run the Actor nightly and commit the CSV so price history lives in git. - **Google Drive**: drop a dated Excel export into a shared folder for the buying team. - **Apify Scheduler**: set a daily or weekly cadence and let the dataset accumulate. ### 🌟 Beyond business use cases - **Research.** Study New Zealand retail price dispersion, seasonal markdown cycles and assortment breadth with real weekly data. - **Personal.** Track a wishlist of appliances and get the numbers when a model actually drops below its usual price. - **Non-profit.** Cost out bulk homeware purchases for community housing, refuges or disaster relief from a single spreadsheet. - **Experimentation.** Use 23 field product rows with images and barcodes as a clean training set for catalog matching, image classification or price prediction projects. ### 🤖 Ask an AI assistant about this scraper Paste this into ChatGPT, Claude or any assistant to get help planning a run: > I am using the Briscoes Scraper on Apify. It returns 23 fields per product from briscoes.co.nz, including imageUrl, title, url, sku, brand, price, priceMax, wasPrice, discountPercent, currency, availability, rating, reviewCount, productType, gtin13, mpn, shippingBand, description, categoryPath, variants and imageGallery. Inputs are startUrls, searchTerms, categorySlugs, maxItems, sortBy, minPrice, maxPrice and includeOutOfStock. Each query returns at most 10,000 products. Help me design a run that tracks weekly price changes across the Kitchen and Electrical categories. ### ❓ Frequently Asked Questions #### Do I need a Briscoes account or an API key? No. Everything the Actor reads is public catalog data that any visitor to briscoes.co.nz can see. #### How many products can one run return? As many as your Max Items allows, up to 1,000,000. A single category or keyword query is capped at 10,000 results by the store itself, so bigger jobs should be split across several categories. Adding more categories in one run raises the total. #### How big is the catalog? Roughly 51,500 products across 690 categories with stock, spread over Kitchen, Bed and Bath, Bath, Dining, Living, Outdoor, Electrical, Cleaning and Laundry, Kids and Nursery, Travel, plus 284 brand pages. #### Why do some products have no image? Briscoes publishes new arrivals before their photography is ready and serves a placeholder in the meantime. Those rows come back with `imageUrl` set to `N/A` rather than a placeholder image URL. About 72 percent of a 150 product sample carried a real photo. #### Why is `rating` often `Not Disclosed`? Only products with published shopper reviews carry a rating. That was about 11 percent of a 150 product sample. Popular appliances tend to have hundreds of reviews, long tail homeware usually has none. #### Does it capture sale prices? Yes. `price` is the current price, `wasPrice` is the pre-markdown price when the item is discounted, and `discountPercent` is the markdown percentage. Products at full price return `N/A` for `wasPrice` and `0` for `discountPercent`. #### What about products that come in several sizes or colours? Configurable products return every variant in the `variants` array with its own SKU, price and stock status. `price` and `priceMax` give you the range at a glance. #### Can I scrape a single product page? Yes. Paste the product URL into Start URLs. The Actor resolves it by the SKU in the URL, so it still works after Briscoes changes the slug. #### Do I need a proxy? No. The catalog service answers normally from Apify's own network, so the proxy input defaults to off. Turn it on for very large jobs or many parallel runs. #### What currency are the prices in? New Zealand dollars. The `currency` field is always `NZD`. #### How fresh is the data? Every row is fetched live at run time and stamped with `scrapedAt`. There is no cache and no stored snapshot. #### Can I filter to in stock products only? Yes. Switch off Include Out Of Stock Products and only products Briscoes currently shows as in stock are returned. #### What happens if a category returns nothing? The run finishes with a warning instead of an error. Check the category slug and any price filters, then run again. ### 🔌 Integrate with any app Datasets are available through the Apify API in JSON, CSV, Excel and XML, so anything that can call an HTTP endpoint can read them. Native integrations cover Make, Zapier, Airbyte, Keboola, Google Drive, Slack, GitHub and webhooks that fire the moment a run finishes. ### 🔗 Recommended Actors - [Costco Product Scraper](https://apify.com/parseforge/costco-scraper) for warehouse club assortment and price data. - [Chewy.com Product Scraper](https://apify.com/parseforge/chewy-com-scraper) for pet retail catalog data. - [Etsy Shop Products Scraper](https://apify.com/parseforge/etsy-scraper) for handmade and homeware listings. - [Rakuten Japan Product Scraper](https://apify.com/parseforge/rakuten-japan-scraper) for the Japanese marketplace. - [RockAuto Parts Scraper](https://apify.com/parseforge/rockauto-scraper) for parts catalogs with part numbers. > 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more retail and marketplace Actors. **🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **⚠️ Disclaimer:** This is an independent tool and is not affiliated with, endorsed by or sponsored by Briscoes Group Limited. It collects only publicly available data from briscoes.co.nz. # Actor input Schema ## `startUrls` (type: `array`): Briscoes category or product page URLs, for example https://www.briscoes.co.nz/kitchen/appliances or https://www.briscoes.co.nz/product/1095486/ninja-foodi-dual-zone-air-fryer-2x3-8lt-af300anz/. Search result URLs with a ?q= parameter also work. ## `searchTerms` (type: `array`): Keywords to run through the Briscoes catalog search, for example "air fryer" or "duvet cover". Each term is scraped independently. ## `categorySlugs` (type: `array`): Briscoes catalog categories to scrape, chosen from the live category tree. Picking a parent category also returns everything in its sub-categories. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `sortBy` (type: `string`): Order the products come back in. Leave empty to use the order Briscoes returns by default. ## `minPrice` (type: `integer`): Only return products priced at or above this amount in New Zealand dollars. ## `maxPrice` (type: `integer`): Only return products priced at or below this amount in New Zealand dollars. ## `includeOutOfStock` (type: `boolean`): Keep products Briscoes currently lists as out of stock. Turn this off to return only products that are in stock right now. ## `proxyConfiguration` (type: `object`): The Briscoes catalog API is open, so no proxy is needed for normal runs. Turn a proxy on for very large jobs or if you run many jobs in parallel. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.briscoes.co.nz/product/1095486/ninja-foodi-dual-zone-air-fryer-2x3-8lt-af300anz/" } ], "searchTerms": [ "air fryer" ], "categorySlugs": [ "kitchen/appliances" ], "maxItems": 10, "includeOutOfStock": true, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): Key product fields in a table view. ## `fullData` (type: `string`): Complete dataset with all 23 fields per product. # 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 = { "startUrls": [ { "url": "https://www.briscoes.co.nz/product/1095486/ninja-foodi-dual-zone-air-fryer-2x3-8lt-af300anz/" } ], "searchTerms": [ "air fryer" ], "categorySlugs": [ "kitchen/appliances" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/briscoes-products-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 = { "startUrls": [{ "url": "https://www.briscoes.co.nz/product/1095486/ninja-foodi-dual-zone-air-fryer-2x3-8lt-af300anz/" }], "searchTerms": ["air fryer"], "categorySlugs": ["kitchen/appliances"], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/briscoes-products-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.briscoes.co.nz/product/1095486/ninja-foodi-dual-zone-air-fryer-2x3-8lt-af300anz/" } ], "searchTerms": [ "air fryer" ], "categorySlugs": [ "kitchen/appliances" ], "maxItems": 10 }' | apify call parseforge/briscoes-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/briscoes-products-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/PQnAqFhOPSL6zFTgo/builds/FOq1yimGIVdX6yT7m/openapi.json