# WooCommerce Products Scraper: Prices, Stock, SKU (`variegated_binturong/woocommerce-products-scraper`) Actor

WooCommerce products scraper for a list of stores, no API key needed: price, regular and sale price, discount, stock status, SKU, categories, tags, brands, image, rating and link, plus a price summary per store. Stores that cannot be read are never charged.

- **URL**: https://apify.com/variegated_binturong/woocommerce-products-scraper.md
- **Developed by:** [Luigi Fiano](https://apify.com/variegated_binturong) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.80 / 1,000 product rows

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 Products Scraper: Prices, Stock, SKU

Paste a list of WooCommerce stores and get every product they sell, one row per product, plus a price summary per store. No API key needed.
Made for e-commerce teams tracking competitor prices and sales, brands and distributors, and agencies sizing up prospect stores.

### What you get

One row per product: name, product type, SKU, price, regular price, sale price and discount, price range for variable products, currency, stock status and low-stock count when the store shows it, categories, tags, brands, attributes, main image and number of images, average rating and number of reviews, short description and link.

Example row:

```json
{
  "type": "product",
  "store": "shop.example.com",
  "productId": "1",
  "name": "Linen Shirt - White",
  "productType": "simple",
  "sku": "LS-W",
  "price": 75,
  "regularPrice": 100,
  "salePrice": 75,
  "onSale": true,
  "discountPercent": 25,
  "priceMin": 75,
  "priceMax": 75,
  "currency": "EUR",
  "inStock": true,
  "stockStatus": "in_stock",
  "stockText": "Only 3 left in stock",
  "lowStockRemaining": 3,
  "purchasable": true,
  "categories": ["Shirts"],
  "tags": ["Summer & Sun"],
  "brands": ["Example Brand"],
  "attributes": { "Size": ["S", "M", "L"] },
  "variationsCount": 0,
  "image": "https://shop.example.com/wp-content/uploads/linen-shirt.jpg",
  "imagesCount": 2,
  "averageRating": 4.5,
  "reviewCount": 12,
  "shortDescription": "Soft cotton & linen",
  "description": null,
  "url": "https://shop.example.com/product/linen-shirt/",
  "slug": "linen-shirt",
  "input": "shop.example.com",
  "error": null,
  "scrapedAt": "2026-10-28T08:00:00.000Z"
}
```

- Prices are normal numbers in the store's currency: the Store API gives amounts in minor units and the Actor converts them.
- `salePrice` is filled only when the product is on sale; `discountPercent` follows from it.
- `stockStatus` is `in_stock`, `out_of_stock` or `on_backorder`.
- Names, categories and descriptions are plain text, without HTML.

Each store also gets an entry in the `SUMMARY` record: products read and delivered, in stock and on sale, minimum, average and maximum price, and which Store API address worked.

### How to use

1. Paste one store per line: a domain (`shop.example.com`) or any URL of the store. If WordPress is installed in a subfolder, give its REST API address (`example.com/shop/wp-json`).
2. Add filters if you want them: a search text, only products in stock, only products on sale, caps per store and per run.
3. Click **Start** and download the results as JSON, CSV or Excel, or read them through the API. Schedule it daily to track prices and sales.

### Input

| Field | What it does | Default |
|---|---|---|
| `stores` | One store per line: a domain or any URL of the store | required |
| `maxProductsPerStore` | Stop reading a store after this many products | 10,000 |
| `maxResults` | Stop the run after this many products, all stores together (0: no limit) | 0 |
| `search` | Only products that the store's own search finds for this text | all products |
| `onlyInStock` | Skip products marked out of stock | false |
| `onlyOnSale` | Keep only products with a sale price lower than the regular price | false |
| `includeDescription` | Add the long description as plain text, up to 5,000 characters (the short one is always there) | false |
| `concurrency` | Stores read at the same time (1-10) | 3 |
| `timeoutSecs` | Timeout per request in seconds (3-120) | 30 |
| `maxRetries` | Retries on timeouts, 429 and 5xx. Retry-After is honoured (0-5) | 3 |
| `maxStores` | Safety cap on input lines | 1,000 |

### Pricing

Pay per event: **$0.0008 per product row** in the dataset ($0.80 per 1,000 products). Stores that cannot be read are not charged: they go to the free `ERRORS` record. Products removed by `onlyInStock` or `onlyOnSale` are not delivered and not charged. Use `maxProductsPerStore` and `maxResults` to cap the cost of a run.

### FAQ

**Do I need an API key from the store owner?**
No. The data comes from the WooCommerce Store API (`/wp-json/wc/store/v1/products`), the public product feed that WooCommerce stores use for their own pages. No login, no cookies, nothing bypassed. Not affiliated with WooCommerce or Automattic.

**What happens with stores that cannot be read?**
A store that is not WooCommerce, or keeps its Store API closed, never becomes a dataset row, so it costs nothing. It is listed with the reason in the `ERRORS` record of the key-value store. When the main address does not answer, the Actor also tries the older Store API address and the form that works without pretty permalinks.

**How are variable products (sizes, colors) handled?**
One row per product: `price` is the lowest current price, `priceMin` and `priceMax` give the range across variations, `attributes` the values offered and `variationsCount` how many variations exist.

**Are reviews or customer data collected?**
No. Only product data. The average rating and the number of reviews are kept; reviews themselves and reviewer names are never collected.

# Actor input Schema

## `stores` (type: `array`):

One store per line: a domain (shop.example.com) or any URL of the store. For WordPress installed in a subfolder, give the URL of its /wp-json (example.com/shop/wp-json).

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

Stop reading a store after this many products.

## `maxResults` (type: `integer`):

Stop the run after this many dataset rows (products) across all stores. 0: no limit.

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

Optional. Only products the store's own search finds for this text. Empty: every product.

## `onlyInStock` (type: `boolean`):

Skip products the store marks as out of stock.

## `onlyOnSale` (type: `boolean`):

Keep only products with a sale price lower than the regular price.

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

Add the long product description as plain text (up to 5,000 characters). The short description is always included.

## `concurrency` (type: `integer`):

How many stores are read at the same time. Pages of one store are read one after the other.

## `timeoutSecs` (type: `integer`):

Give up on a request after this many seconds.

## `maxRetries` (type: `integer`):

How many times a request is retried after a timeout, a 429 or a 5xx response. Retry-After is honoured.

## `maxStores` (type: `integer`):

Safety cap on the number of input lines processed.

## Actor input object example

```json
{
  "stores": [
    "https://mercantile.wordpress.org",
    "https://woocommerce.com"
  ],
  "maxProductsPerStore": 100,
  "maxResults": 0,
  "search": "",
  "onlyInStock": false,
  "onlyOnSale": false,
  "includeDescription": false,
  "concurrency": 3,
  "timeoutSecs": 30,
  "maxRetries": 3,
  "maxStores": 1000
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `errors` (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 = {
    "stores": [
        "https://mercantile.wordpress.org",
        "https://woocommerce.com"
    ],
    "maxProductsPerStore": 100
};

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

# Prepare the Actor input
run_input = {
    "stores": [
        "https://mercantile.wordpress.org",
        "https://woocommerce.com",
    ],
    "maxProductsPerStore": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("variegated_binturong/woocommerce-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 '{
  "stores": [
    "https://mercantile.wordpress.org",
    "https://woocommerce.com"
  ],
  "maxProductsPerStore": 100
}' |
apify call variegated_binturong/woocommerce-products-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,variegated_binturong/woocommerce-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 <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/chxt9LCdchL4Tq2Fz/builds/uobSnGG1cBHhUU10q/openapi.json
