# WooCommerce Scraper (`anyxsolutions/woocommerce-scraper`) Actor Scrape products from any WooCommerce store: names, prices and sale prices, stock, SKUs, ratings, categories, attributes, variations, images and full descriptions. Paste a store, category, search or product URL and get clean JSON. No login, no API key, no proxy. - **URL**: https://apify.com/anyxsolutions/woocommerce-scraper.md - **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 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? 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 ![banner](https://anyx.solutions/banners/woocommerce-scraper.png) ## WooCommerce Scraper **Every product in any WooCommerce store — prices, sale prices, stock, ratings, attributes, variations, images and descriptions — as clean JSON.** WooCommerce powers millions of online shops, from household brands like Aunt Fannie's to fashion boutiques, food sellers and software marketplaces. This Actor reads any WooCommerce store and returns its products: name, SKU, product type, the full and short descriptions as HTML and plain text, the current, regular and sale prices in the store's currency, whether the product is in stock, its average rating and review count, categories, tags, brands, every image, the product attributes (such as Size or Scent) and every variation. Paste a store's home page to get the whole catalog, a category page to get one category, a shop search to get matching products, or product URLs for specific items; there is no login, no API key, and no proxy to configure. Built for competitor price monitoring, product research, catalog migration, and e-commerce market analysis. ### ⚡ Quick start ```json { "startUrls": [{ "url": "https://auntfannies.com/" }], "maxItems": 5 } ``` ### 🧩 Input | Field | Type | Required | Default | Description | | -------------------- | ------- | -------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | yes | — | WooCommerce store URLs: a store's home or shop page (whole catalog), a category page (`…/product-category//`, or the store's own category address), a shop search (`…/?s=&post_type=product`), or a product page (`…/product//`). Any store domain works. | | `maxItems` | integer | no | — | Maximum number of products per start URL. The input form starts at 5; leave it empty to get the whole store, category or search. | | `proxyConfiguration` | object | no | `{ "useApifyProxy": false }` | Proxy settings. WooCommerce stores need no proxy; switch one on only if a store's firewall blocks the run. | **Is a site on WooCommerce?** Most WooCommerce stores have product pages under `/product//` and category pages under `/product-category//`, and run on WordPress. Give the Actor any URL from the store; if the site is not a WooCommerce store, or the store has switched off its public product data, the run log says which and the run finishes without results. ### 📤 Output Each product is one dataset row. Prices are in the store's own currency, in whole units (`12.99` means 12.99, not cents). #### Fields | Field | Type | Description | | ---------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- | | `id` | number | WooCommerce product ID. | | `name` | string | Product name. | | `slug` | string | The product's name in its URL. | | `url` | string | The product page. | | `store` | string | The store's domain. | | `sku` | string | Stock-keeping unit (SKU), when the store sets one. | | `type` | string | Product type: `simple`, `variable`, `grouped`, `external`, or a type an extension adds (such as `subscription`). | | `descriptionHtml` | string | Full product description as HTML. | | `descriptionText` | string | Full product description as plain text. | | `shortDescriptionHtml` | string | Short description (the summary next to the price) as HTML. | | `shortDescriptionText` | string | Short description as plain text. | | `price` | number | Current price: the sale price when on sale, else the regular price. For a variable product, the lowest variation price. | | `regularPrice` | number | Regular (before-sale) price. | | `salePrice` | number | Sale price, when the product is on sale. | | `priceMin` | number | Lowest price across variations; the price itself for other products. | | `priceMax` | number | Highest price across variations; the price itself for other products. | | `currency` | string | The store's currency (ISO 4217 code). | | `currencySymbol` | string | The currency symbol the store shows, such as `$` or `€`. | | `onSale` | boolean | True when the product is on sale. | | `isInStock` | boolean | True when the product can be bought now. | | `stockAvailability` | string | Stock status as the store words it, such as "In stock", "Out of stock" or "Only 2 left in stock". | | `averageRating` | number | Average review rating, 0 to 5 (0 when the product has no reviews). | | `reviewCount` | number | Number of reviews. | | `categories` | array | Product categories: `id`, `name`, `slug`, `url`. | | `tags` | array | Product tags. | | `brands` | array | Product brands, on stores that use WooCommerce brands. | | `images` | array | Product images: `src`, `alt`, `name`. | | `attributes` | array | Product attributes (such as Size or Scent): `name`, `terms`, and `usedForVariations`. | | `variations` | array | Every variation that can be bought: `id` and its `attributes` (`name`, `value`; `value` is null when any value fits). |
Example output ```json { "id": 55218, "name": "Carpet Refresher", "slug": "carpet-refresher", "url": "https://auntfannies.com/product/carpet-refresher/", "store": "auntfannies.com", "sku": "CRR", "type": "variable", "descriptionHtml": "

\nThe Power of Baking Soda\n
    \n
  • Helps neutralize odors – freshens the air without heavy perfumes.
    • \n
  • Keeps homes smelling and feeling fresh.
    • \n
  • Formulated with simple ingredients.
    • \n
\n

\"\"

\n

\n

\n\n

\nTips & tricks\n
    \n
  • Allow to rest up to 15 minutes to absorb more odors. Vacuum away.
    • \n
  • Tackle carpet, area rugs – even the sofa!
    • \n
\n

\n

\n\n

\n

Clean without compromise.

\n
\n\n\n

\n

\n
", "descriptionText": "The Power of Baking Soda\nHelps neutralize odors – freshens the air without heavy perfumes.\nKeeps homes smelling and feeling fresh.\nFormulated with simple ingredients.\n\nTips & tricks\nAllow to rest up to 15 minutes to absorb more odors. Vacuum away.\nTackle carpet, area rugs – even the sofa!\n\nClean without compromise.", "shortDescriptionHtml": "

Fan favorite! Go ahead and sprinkle Carpet Refresher throughout your home to help neutralize odors and brighten your day.

", "shortDescriptionText": "Fan favorite! Go ahead and sprinkle Carpet Refresher throughout your home to help neutralize odors and brighten your day.", "price": 12.99, "regularPrice": 12.99, "salePrice": null, "priceMin": 12.99, "priceMax": 12.99, "currency": "USD", "currencySymbol": "$", "onSale": false, "isInStock": true, "stockAvailability": "In stock", "averageRating": 4.74, "reviewCount": 228, "categories": [ { "id": 60, "name": "Best Sellers", "slug": "best-sellers", "url": "https://auntfannies.com/shop/best-sellers/" }, { "id": 215, "name": "Carpet Refreshers", "slug": "carpet-refreshers", "url": "https://auntfannies.com/shop/carpet-refreshers/" } ], "tags": [], "brands": [], "images": [ { "src": "https://auntfannies.com/wp-content/uploads/2020/03/Carpet_refresh_wide_V2.jpg", "alt": null, "name": "Carpet_refresh_wide_V2" } ], "attributes": [ { "name": "Scent", "terms": ["Bright Lemon", "Lavender"], "usedForVariations": true }, { "name": "Size", "terms": ["2-Pack", "6-Pack", "Single Canister"], "usedForVariations": true } ], "variations": [ { "id": 117888, "attributes": [ { "name": "Scent", "value": "Lavender" }, { "name": "Size", "value": "Single Canister" } ] }, { "id": 117887, "attributes": [ { "name": "Scent", "value": "Bright Lemon" }, { "name": "Size", "value": "Single Canister" } ] } ] } ```
### 💡 Use cases - **Competitor price monitoring** — track prices, sales and regular prices across the WooCommerce stores you compete with, and catch every discount. - **Stock tracking** — see which products sell out and when they come back. - **Product research** — find what a brand sells, how it prices it, and how shoppers rate it. - **Catalog migration and feeds** — export a store's full catalog, with SKUs, attributes, variations and images, into another platform or a product feed. - **Market analysis** — compare assortments, categories and price bands across many stores in a niche. ### ❓ FAQ - **Do I need an API key or a store account?** No. The Actor reads the same public product data any shopper sees. - **Do I need a proxy?** No. It runs without one by default. A few stores sit behind a strict firewall; if the run log says the store blocked the request, switch on a proxy. - **Does it work on every WooCommerce store?** It works on stores that share WooCommerce's standard public product data, which is the large majority. A store that has switched it off, or a WordPress site without a WooCommerce shop, is reported in the run log instead of returning partial results. - **My store's category pages are not under `/product-category/`. Will they work?** Yes. Stores often rename that part of the address (for example `/shop//`); the Actor matches any category page against the store's own categories. - **Why is `salePrice` empty?** The product is not on sale. - **Why do variations show only some sizes?** The store chooses which variations to show, and many hide the sold-out ones. - **Can I scrape many stores at once?** Yes. Add one URL per store, category or search to `startUrls`; `maxItems` applies to each one separately. ### 🔗 More scrapers by Anyx - [Shopify Scraper](https://apify.com/anyxsolutions/shopify-scraper) - [Walmart Scraper](https://apify.com/anyxsolutions/walmart-scraper) - [Target Scraper](https://apify.com/anyxsolutions/target-scraper) - [AliExpress Scraper](https://apify.com/anyxsolutions/aliexpress-scraper) ### 🤝 Anyx Solutions We build custom scrapers and data-extraction pipelines. - Email: tantosthor@gmail.com ### 🖼 Image credit Image credit: [woocommerce.com](https://woocommerce.com/) # Actor input Schema ## `startUrls` (type: `array`): WooCommerce store URLs: a store's home or shop page such as https://auntfannies.com, a category page (…/product-category//), a product page (…/product//), or a shop search (…/?s=\&post_type=product). Any WooCommerce store works, on its own domain. ## `maxItems` (type: `integer`): Maximum number of products to return per start URL. Leave empty to get the whole store, category or search. ## `proxyConfiguration` (type: `object`): Proxy settings. WooCommerce stores need no proxy; switch one on only if a store's firewall blocks the run. ## Actor input object example ```json { "startUrls": [ { "url": "https://auntfannies.com/" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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://auntfannies.com/" } ], "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("anyxsolutions/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 = { "startUrls": [{ "url": "https://auntfannies.com/" }], "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("anyxsolutions/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 '{ "startUrls": [ { "url": "https://auntfannies.com/" } ], "maxItems": 5 }' | apify call anyxsolutions/woocommerce-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/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/ACPVDc8comTGgyaa3/builds/SyC4dHiDp0C2heVYc/openapi.json