# WooCommerce Scraper: Products, Prices, Stock (`deriverge/woocommerce-scraper`) Actor Scrape products from any WooCommerce store: prices, regular and sale prices, discounts, stock status and low stock, SKUs, categories, tags, brands, attributes, ratings and images, with every variation on request. Price and stock alerts between runs. JSON, CSV, Excel, API. - **URL**: https://apify.com/deriverge/woocommerce-scraper.md - **Developed by:** [deriverge s.r.o.](https://apify.com/deriverge) (community) - **Categories:** E-commerce, Lead generation, Developer tools - **Features:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.40 / 1,000 products 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? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## WooCommerce Scraper WooCommerce Scraper reads the product catalog of a WooCommerce store through the Store API that WooCommerce serves to every visitor, one row per product: title, SKU, price, regular and sale price with the discount, stock status, categories, tags, attributes, rating and images, and on request each variation with its own price and stock. Enter a store domain such as `nalgene.com` in **Stores** and click **Start**. A store that has switched its Store API off cannot be read and returns no rows. It costs $0.80 per 1,000 products on the Free plan ($0.40 on Business), and the $5 of monthly credit in Apify's Free plan covers about 6,200 products. ### What data does it return? | Field | Description | |---|---| | `store`, `storeName` | The store's domain and its site name, such as `nalgene.com` and `Nalgene`. | | `productId`, `slug`, `url`, `title` | WooCommerce's product ID, the URL slug, the product page and the product name. | | `type`, `sku` | `simple`, `variable`, `grouped` or `external`, and the store's SKU, such as `Z0124`. | | `categories`, `tags`, `brands` | Category and tag names, such as `Today's Sales`, and brand names in stores that use WooCommerce brands. | | `currency`, `price`, `regularPrice`, `salePrice` | The currency code and the current, regular and sale price as numbers, converted from the minor units the Store API sends. For a variable product, `price` is its lowest price. | | `minPrice`, `maxPrice` | Lowest and highest price across the variations; the same as `price` for a simple product. | | `onSale`, `discountPercent` | `true` when a sale price applies, and the discount in whole percent: `33` for 9.99 instead of 14.99. | | `inStock`, `stockStatus`, `onBackorder` | Whether the product can be bought, the store's stock text such as `Out of stock` or `In stock (can be backordered)`, and whether it takes backorders. | | `lowStockRemaining` | Units left, filled only when the store shows a low stock warning. | | `averageRating`, `reviewCount` | Average customer rating from 1 to 5, `null` without reviews, and the number of reviews. | | `attributes` | Every attribute with its values, such as `Bottle Color` with `Blue`, `Clear` and `Gray`. | | `variationCount`, `variations` | How many variations the product has, and with **Include variations** each one with its attributes, SKU, price, regular price, stock and low stock count. | | `image`, `images` | The main image and all product images. | | `shortDescription`, `description` | The short description as plain text, always, and the full description with **Include full descriptions**. | | `change`, `previousPrice` | With a watch name: `new`, `price_drop`, `price_increase`, `back_in_stock` or `sold_out`, and the price at the previous run. | | `checkedAt` | When the product was read, as an ISO 8601 UTC timestamp. | ### How to scrape a WooCommerce store 1. Enter one or more stores in **Stores**, one per line, as a domain (`nalgene.com`) or a URL. The actor asks each store for `/wp-json/wc/store/v1/products`, which WooCommerce serves without a key unless the owner turned it off. 2. Set **Maximum products per store** (1,000 by default) and **Maximum rows** for the whole run. 3. Turn on **Include variations** for sizes and colors with their own price, SKU and stock. It costs one extra request per variable product. **Include full descriptions** adds the long product text. 4. Keep only what you need with **Keywords (any of)**, which looks at the title, categories, tags and brands, **Only products in stock** and **Only products on sale**. 5. Click **Start**. Products appear in the **Output** tab, ready to export as CSV, Excel or JSON. The `SUMMARY` record in the key-value store gives each store's status (`ok`, `failed`, `blocked`, `robots_disallowed` or `invalid_input`) with the reason. A daily price watch over the API, with variations, for products on sale: ```json { "stores": ["nalgene.com"], "includeVariations": true, "onlyOnSale": true, "watchName": "nalgene-sale" } ``` ### Example output A product from a run on 11 October 2026 with full descriptions on and variations off, so `variations` is empty while `variationCount` shows 6. ```json { "store": "nalgene.com", "storeName": "Nalgene", "productId": 744171, "slug": "744171", "url": "https://nalgene.com/product/744171/", "title": "20oz Multi-Drink Bottle", "type": "variable", "sku": "Z0124", "categories": [ "By Shape", "By Size", "Today's Sales" ], "tags": [], "brands": [], "currency": "USD", "price": 9.99, "regularPrice": 14.99, "salePrice": 9.99, "minPrice": 9.99, "maxPrice": 9.99, "discountPercent": 33, "onSale": true, "inStock": false, "stockStatus": "Out of stock", "lowStockRemaining": null, "onBackorder": false, "averageRating": 5, "reviewCount": 1, "attributes": [ { "name": "Cap Diameter", "values": [ "2.5 inches (63mm)" ] }, { "name": "Cap Material", "values": [ "Silicone" ] }, { "name": "Country of Origin", "values": [ "China", "USA" ] }, { "name": "Bottle Color", "values": [ "Blue", "Clear", "Gray", "Green", "Purple", "Red" ] }, { "name": "Filter Color", "values": [ "Blue", "Clear", "Gray", "Green", "Purple", "Red" ] }, { "name": "Lid Type", "values": [ "Straw" ] }, { "name": "Material", "values": [ "Tritan Renew" ] }, { "name": "Bottle Volume", "values": [ "20oz" ] } ], "variationCount": 6, "variations": [], "image": "https://nalgene.com/wp-content/uploads/2020/04/1790-1020.jpg", "images": [ "https://nalgene.com/wp-content/uploads/2020/04/1790-1020.jpg" ], "shortDescription": "A 20oz bottle with a diverse lid. Drink 3 ways: wide mouth, narrow mouth or from the straw.", "description": "The perfect bottle for people who prefer straws. This 20oz bottle comes with the only Nalgene cap with a straw. This do-it-all lid allows you to drink 3 ways: wide mouth, narrow mouth or from the straw. Plus the cap can be used on any Nalgene Wide Mouth bottle (20oz or larger).", "change": null, "previousPrice": null, "checkedAt": "2026-10-11T17:22:44.500Z" } ``` ### How much does it cost to scrape WooCommerce products? | | Free plan | Starter | Scale | Business | |---|---|---|---|---| | 1,000 products | $0.80 | $0.64 | $0.52 | $0.40 | You pay only for the events in the table. There is no start fee, and compute time and proxies are included. The first 100 products of nalgene.com with full descriptions cost $0.08 on the Free plan and $0.04 on Business on 11 October 2026; the run took 9 seconds and two requests to the store. A catalog of 1,000 products costs $0.80 on the Free plan. Stores that cannot be read and products your filters remove are not charged. ### Limits - Products are read 100 per request. **Maximum products per store** counts products read before your filters, so with filters a store can return fewer rows than that number. - A site without the Store API answers with an error, and `SUMMARY` notes that it has no public WooCommerce product feed. Such a store costs nothing. - Before any request, the actor checks the store's `robots.txt`. A store that disallows the Store API is skipped with the status `robots_disallowed`, and nothing is read or charged. - When a store answers HTTP 429, the actor waits as long as the store asks and slows down. After four such answers in a row, or at once on HTTP 403 or a bot protection page, it stops reading that store for the rest of the run, keeps the products already read and gives the reason in `SUMMARY`. It does not switch to other IP addresses. - With **Include variations** on, the actor reads one extra page per variable product, 6 at a time. Of the first 100 products at nalgene.com, 52 were variable, with 354 variations in all. - Exact stock counts are not public in WooCommerce. `lowStockRemaining` appears only where the store shows a low stock warning; none of the 100 Nalgene products had one. - Prices are those a visitor without an account sees. Prices for logged-in customers, wholesale tiers and cart discounts are not part of the Store API. ### Price and stock monitoring Give the run a **Watch name (price and stock alerts)**, such as `nalgene-sale`, or save it as a task, and schedule it. The first run stores each product's price and stock. From the second run on, each product carries `change` and `previousPrice`, and the `CHANGES` record counts new products, price drops and increases, restocks and sell-outs and lists the products that left the store. With **Return only changes since the last run** on, only changed products are returned and charged. A store that was read only in part keeps its earlier snapshot for the products not reached, so they are not reported as removed. ### FAQ #### Is it legal to scrape WooCommerce stores? The actor reads the product data that WooCommerce's Store API gives every visitor, the same data the shop pages display, after checking the store's `robots.txt`. It never touches customer accounts, orders or reviewers' details. Product photos and texts belong to the store, and you are responsible for how you use them and the rest of the data. #### How do I know whether a site runs WooCommerce? Enter it and look at `SUMMARY`: a site without a public WooCommerce product feed is named there at no cost. To check many sites first, our Tech Stack Detector recognizes WooCommerce among other platforms. ### Related scrapers - [Shopify Products Scraper](https://apify.com/deriverge/shopify-products-scraper) - [Shopify Store Analyzer](https://apify.com/deriverge/shopify-store-analyzer) - [Tech Stack Detector](https://apify.com/deriverge/tech-stack-detector) - [Company Enrichment by Domain](https://apify.com/deriverge/company-enrichment) ### Support This actor is built and maintained by deriverge s.r.o., a software company based in the Czech Republic. If a run fails or a field you need is missing, please open an issue in the **Issues** tab or write to us at info@deriverge.com. We respond in English and Czech. Runs can be scheduled in Apify Console or started from the **API** tab, which has examples for Python, JavaScript and cURL and works with Make, Zapier, n8n and the Apify MCP server. If the actor saves you time, a short review helps other people find it. # Changelog This Actor's version history is a separate document: https://apify.com/deriverge/woocommerce-scraper/changelog.md # Actor input Schema ## `stores` (type: `array`): WooCommerce store domains or URLs, one per line, for example nalgene.com. Works with stores whose public Store API is on, which is the WooCommerce default. ## `maxProductsPerStore` (type: `integer`): Stop after this many products in each store. ## `includeVariations` (type: `boolean`): For products with variations (sizes, colors), add each variation with its own price, SKU and stock. One extra request per variable product. ## `includeDescription` (type: `boolean`): Add the full product description as plain text (the short description is always included). ## `keywords` (type: `array`): Keep only products whose title, categories, tags or brands contain one of these. ## `onlyInStock` (type: `boolean`): Skip products that are out of stock. ## `onlyOnSale` (type: `boolean`): Keep only products with a sale price. ## `changesOnly` (type: `boolean`): With a watch name or a saved task, return only new products, price drops and increases, and products back in stock or sold out. ## `watchName` (type: `string`): Give the run a name such as "competitors" and schedule it. Every later run with the same name fills change and previousPrice on each product and lists removed products in the CHANGES record. Runs from a saved task are compared automatically. ## `maxItems` (type: `integer`): Hard cap on returned products in the run. ## Actor input object example ```json { "stores": [ "nalgene.com" ], "maxProductsPerStore": 1000, "includeVariations": false, "includeDescription": false, "onlyInStock": false, "onlyOnSale": false, "changesOnly": false, "maxItems": 20 } ``` # Actor output Schema ## `products` (type: `string`): One row per product with prices, discounts, stock, SKU, categories, ratings and images. ## `changes` (type: `string`): Counts of new products, price changes and stock changes, and the list of products removed from each store. ## `summary` (type: `string`): Products read per store and why a store could not be read. # 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 = { "stores": [ "nalgene.com" ], "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("deriverge/woocommerce-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 = { "stores": ["nalgene.com"], "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("deriverge/woocommerce-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 '{ "stores": [ "nalgene.com" ], "maxItems": 20 }' | apify call deriverge/woocommerce-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,deriverge/woocommerce-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/FLRELol6CdgH390ga/builds/frvpWQu5y457VIEzJ/openapi.json