# WooCommerce Store Products Scraper – Prices, Sales & Stock (`loudtzu/woocommerce-store-products`) Actor

Export products from any WooCommerce shop through its public Store API: name, SKU, price, regular and sale price, currency, stock, rating, categories, attributes, images. Search or sale-only filters. $0.00026 per product + $0.0005 per run.

- **URL**: https://apify.com/loudtzu/woocommerce-store-products.md
- **Developed by:** [LOUDTZU TZULOUD](https://apify.com/loudtzu) (community)
- **Categories:** E-commerce, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.26 / 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.

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 Store Products Scraper – Prices, Sales & Stock

Give it one or more WooCommerce shop addresses. It returns the shop's products with name, SKU, current, regular and sale price, currency, stock, rating, categories, attributes and images. One row per product. You can filter by search text or "on sale only".

It reads WooCommerce's own public **Store API** (`/wp-json/wc/store/v1/products`), the same API the shop's cart and checkout blocks use. No login, no browser, no residential proxies.

### What you can use it for

- **Competitor price tracking** and sale monitoring.
- **Catalogue export** from a supplier's shop to a spreadsheet.
- **Market research:** product counts, price bands, ratings by category.

### Input

| Field | What it does | Default |
|---|---|---|
| Store URLs | One shop per line, e.g. `https://shop.example.com` | mercantile.wordpress.org |
| Search | Only products matching this text (the shop's own search) | – |
| On sale only | Only products marked on sale | off |
| Max products per store | 1–50,000 | 100 |
| Include descriptions | Short and full description as plain text (emails and phone numbers removed) | on |

Example input:

```json
{ "storeUrls": ["https://www.awesomeinventions.com"], "search": "lamp", "maxProductsPerStore": 200 }
```

### Output (one row per product)

```json
{
  "store": "www.awesomeinventions.com",
  "productId": 357184,
  "name": "4 Person Barrel Sauna",
  "url": "https://www.awesomeinventions.com/shop/4-person-barrel-sauna/",
  "sku": null,
  "type": "external",
  "price": 1.0,
  "regularPrice": 2.0,
  "salePrice": 1.0,
  "currency": "GBP",
  "onSale": true,
  "discountPct": 50,
  "inStock": true,
  "averageRating": 0.0,
  "reviewCount": 0,
  "categories": ["Outdoor"],
  "imageUrl": "https://…jpg"
}
```

Prices are converted from the API's minor units (cents) using the shop's own currency settings. Variable products also get `priceRangeMin`/`priceRangeMax`.

### Pricing

Pay per result:

- **$0.00026 per product** saved (= $0.26 per 1,000 products)
- **$0.0005 per run**, charged only once the first product is saved.

Shops that give nothing (not WooCommerce, API off, blocked, robots.txt says no) cost nothing. "Max charge per run" is respected: the run stops cleanly and the status says so.

### Rivals (checked 2026-11-05)

Live Apify Store prices read on 2026-11-05 (~16:30 AST) from the Store API. One row per Apify plan (Free, Bronze, Silver, Gold, Platinum, Diamond). Users = monthly users at that time. Prices change; check the Store before relying on them.

| Actor | Users (30 d) | Plan | Main result price | Start fee |
|---|---|---|---|---|
| trovevault/woocommerce-products-scraper | 13 | Free | $0.001 per result | $0.001 |
| trovevault/woocommerce-products-scraper | 13 | Bronze | $0.00095 per result | $0.00095 |
| trovevault/woocommerce-products-scraper | 13 | Silver | $0.0009 per result | $0.0009 |
| trovevault/woocommerce-products-scraper | 13 | Gold | $0.00085 per result | $0.00085 |
| trovevault/woocommerce-products-scraper | 13 | Platinum | $0.00085 per result | $0.00085 |
| trovevault/woocommerce-products-scraper | 13 | Diamond | $0.00085 per result | $0.00085 |
| piotrv1001/woocommerce-product-scraper | 6 | Free | $0.0012 per result | $0.00005 |
| piotrv1001/woocommerce-product-scraper | 6 | Bronze | $0.0012 per result | $0.00005 |
| piotrv1001/woocommerce-product-scraper | 6 | Silver | $0.0012 per result | $0.00005 |
| piotrv1001/woocommerce-product-scraper | 6 | Gold | $0.0012 per result | $0.00005 |
| piotrv1001/woocommerce-product-scraper | 6 | Platinum | $0.0012 per result | $0.00005 |
| piotrv1001/woocommerce-product-scraper | 6 | Diamond | $0.0012 per result | $0.00005 |
| autofacts/woocommerce-scraper | 3 | Free | $0.0012 per product | $0.00005 |
| autofacts/woocommerce-scraper | 3 | Bronze | $0.0011 per product | $0.00005 |
| autofacts/woocommerce-scraper | 3 | Silver | $0.001 per product | $0.00005 |
| autofacts/woocommerce-scraper | 3 | Gold | $0.00085 per product | $0.00005 |
| autofacts/woocommerce-scraper | 3 | Platinum | $0.00085 per product | $0.00005 |
| autofacts/woocommerce-scraper | 3 | Diamond | $0.00085 per product | $0.00005 |
| dheerajitbhu/woocommerce-products-scraper | 1 | Free | $0.0005 per product | $0.001 |
| dheerajitbhu/woocommerce-products-scraper | 1 | Bronze | $0.00045 per product | $0.001 |
| dheerajitbhu/woocommerce-products-scraper | 1 | Silver | $0.0004 per product | $0.001 |
| dheerajitbhu/woocommerce-products-scraper | 1 | Gold | $0.00035 per product | $0.001 |
| dheerajitbhu/woocommerce-products-scraper | 1 | Platinum | $0.00035 per product | $0.001 |
| dheerajitbhu/woocommerce-products-scraper | 1 | Diamond | $0.00035 per product | $0.001 |
| northbell/woocommerce-product-price-tracker | 1 | Free | $0.0005 per product | $0.01 |
| northbell/woocommerce-product-price-tracker | 1 | Bronze | $0.0005 per product | $0.01 |
| northbell/woocommerce-product-price-tracker | 1 | Silver | $0.00045 per product | $0.01 |
| northbell/woocommerce-product-price-tracker | 1 | Gold | $0.0004 per product | $0.01 |
| northbell/woocommerce-product-price-tracker | 1 | Platinum | $0.0004 per product | $0.01 |
| northbell/woocommerce-product-price-tracker | 1 | Diamond | $0.0004 per product | $0.01 |
| **This Actor** | – | All plans | **$0.00026 per product** | $0.0005 (only after the first product) |

### What to expect from a run

- **Expected case:** clean runs on real, working stores that save several products. That is what the price is designed for.
- **Bad URLs still use some compute:** a store that is blocked, isn't a store of this type, has no products, or is closed by robots.txt still takes a few requests (and some run time) before the Actor can tell. It returns no products, and **nothing is charged for it**: no product fee, and no run fee if no product is saved at all. Each such store is listed with its reason in the `ERRORS` record and the status message.
- If every store in a run fails, the run ends with "0 products saved … Nothing was charged."

### Legal and fair use

- **Public data only.** The Store API is public and unauthenticated by design. The Actor never logs in; if a shop requires a login (HTTP 401/403 on the API) it is skipped.
- **robots.txt is checked for every shop** before any product request. If it disallows `/wp-json/`, the shop is skipped and listed in ERRORS; the Actor does not try other addresses to get around it. (The `?rest_route=` address is used only for shops whose `/wp-json/` address does not exist, i.e. HTTP 404.) Unreadable robots.txt (server error) = shop skipped (RFC 9309). `Crawl-delay` for all agents is honoured (up to 30 s).
- **Terms:** each shop has its own terms; some forbid automated copying. You are responsible for checking them and for your use of the data.
- **No personal data.** Only product data is read: no reviews, no customers, no orders. Descriptions are scrubbed of email addresses and phone numbers.
- Requests go one at a time per shop through Apify's datacenter proxy.

### FAQ

**How do I know if a site uses WooCommerce?**
Just add it. If there is no public Store API, the run says so in the ERRORS record and charges nothing for that shop.

**My shop is WooCommerce but it says "no public Store API".**
The Store API arrived in WooCommerce 4.x and can be disabled by plugins or security settings. Older or locked-down shops can't be read.

**Are stock quantities shown?**
Only "in stock / on backorder" and the shop's own stock text. Exact counts are not public.

**Are variations listed separately?**
No. One row per product, with `variationCount`, `attributes` and the variation price range.

**What are "external" products?**
Affiliate products that link to another site to buy. They are kept, with `type` = `external`.

**Where are problems listed?**
In the run's key-value store, record `ERRORS`, and in the status message.

# Actor input Schema

## `storeUrls` (type: `array`):

One WooCommerce shop per line, e.g. 'https://shop.example.com'. Only the site address is used. Empty lines stop the run before anything is charged. If you leave this out, the Actor reads mercantile.wordpress.org (the official WordPress swag shop).

## `search` (type: `string`):

Only products matching this text, using the shop's own search.

## `onSaleOnly` (type: `boolean`):

Only products the shop marks as on sale.

## `maxProductsPerStore` (type: `integer`):

Stop after this many products from each shop (default 100, max 50,000).

## `includeDescription` (type: `boolean`):

Add short and full descriptions as plain text (emails and phone numbers removed).

## Actor input object example

```json
{
  "storeUrls": [
    "https://mercantile.wordpress.org"
  ],
  "onSaleOnly": false,
  "maxProductsPerStore": 100,
  "includeDescription": true
}
```

# Actor output Schema

## `products` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "storeUrls": [
        "https://mercantile.wordpress.org"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("loudtzu/woocommerce-store-products").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "storeUrls": ["https://mercantile.wordpress.org"] }

# Run the Actor and wait for it to finish
run = client.actor("loudtzu/woocommerce-store-products").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 '{
  "storeUrls": [
    "https://mercantile.wordpress.org"
  ]
}' |
apify call loudtzu/woocommerce-store-products --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,loudtzu/woocommerce-store-products"
        }
    }
}
```

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 <APIFY_API_TOKEN>` 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/tMqd9U4rFV2gz5RCx/builds/N7YkU9vIVIYN24erC/openapi.json
