# Shopify & WooCommerce Products Feed (`henryklimes/ecommerce-products-feed`) Actor

Use this when you need the full product catalog of a public Shopify or WooCommerce store: prices, sale prices, variants, SKUs, stock and images, on one schema. Input store URLs. Public JSON endpoints, no login and no browser. $1 per 1,000 products.

- **URL**: https://apify.com/henryklimes/ecommerce-products-feed.md
- **Developed by:** [Jindrich Klimes](https://apify.com/henryklimes) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 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

## Shopify & WooCommerce Products Feed

**Shopify & WooCommerce Products Feed exports the full product catalog of a public Shopify or WooCommerce store as clean JSON or CSV — titles, prices, sale prices, variants, SKUs, stock, images, categories and tags.**

Paste store URLs; the Actor detects the platform and reads the store's own public catalog endpoints (Shopify `products.json`, WooCommerce Store API). No browser, no login, no proxies. Use `maxProducts` to cap a first run; remove the cap to export a full catalog, including stores with thousands of products.

### Why use it

✅ **Two platforms, one schema** — Shopify and WooCommerce products in the same normalized format\
✅ **Variants included** — size/colour options, per-variant price, compare-at price, SKU and availability\
✅ **Prices done right** — WooCommerce minor units converted, store currency attached, sale detection\
✅ **Collections** — pass a Shopify collection URL to export just that collection\
✅ **Polite by design** — honours each store's robots.txt, paces requests, backs off on rate limits\
✅ **Ready for spreadsheets and BI** — one row per product, variants nested

### Input

```json
{
  "storeUrls": [
    "https://www.allbirds.com",
    "https://colourpop.com/collections/lips",
    "https://porterandyork.com"
  ],
  "platform": "auto",
  "includeDescription": true,
  "onlyInStock": false,
  "fetchWooVariations": false,
  "maxProductsPerStore": 5000
}
```

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `storeUrls` | Array | — | Store homepages or Shopify collection URLs |
| `platform` | `auto` / `shopify` / `woocommerce` | `auto` | Force a platform or auto-detect |
| `includeDescription` | Boolean | `true` | Plain-text product descriptions |
| `onlyInStock` | Boolean | `false` | Skip products with no available variant |
| `fetchWooVariations` | Boolean | `false` | Fetch per-variation price, SKU and stock on WooCommerce (extra requests) |
| `maxProducts` | Integer | — | Cap across all stores |
| `maxProductsPerStore` | Integer | — | Cap per store |
| `pageDelayMs` | Integer | `500` | Pause between catalog pages |

### Output

```json
{
  "platform": "shopify",
  "store_url": "https://www.allbirds.com",
  "store_name": "Allbirds",
  "product_id": "7292464824400",
  "title": "Men's Wool Runner",
  "handle": "mens-wool-runners",
  "url": "https://www.allbirds.com/products/mens-wool-runners",
  "brand": "Allbirds",
  "product_type": "Shoes",
  "categories": ["Shoes"],
  "tags": ["mens", "runner"],
  "description_text": "Our original wool sneaker…",
  "currency": "USD",
  "price": 98,
  "price_min": 98,
  "price_max": 110,
  "compare_at_price": 120,
  "on_sale": true,
  "in_stock": true,
  "sku": null,
  "variants_count": 2,
  "variants": [
    { "id": "11", "title": "8 / Grey", "sku": "WR-8-G", "price": 98, "compare_at_price": 120, "available": false, "options": { "Size": "8", "Color": "Grey" } }
  ],
  "image_url": "https://cdn.shopify.com/…jpg",
  "images": ["https://cdn.shopify.com/…jpg"],
  "rating": null,
  "review_count": null,
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2026-11-01T00:00:00Z",
  "published_at": "2025-01-02T00:00:00Z",
  "scraped_at": "2026-11-14T17:34:12.858Z"
}
```

The `OUTPUT` record summarises each store: detected platform, products found and exported, and any error (e.g. a store whose robots.txt disallows its catalog endpoint).

### How to export all products from any Shopify store (products.json)

Most Shopify stores publish their catalog at `/products.json`. Paste the store homepage into `storeUrls` and the Actor pages through that endpoint, 250 products at a time, until the whole catalog is read. Pass a collection URL such as `https://colourpop.com/collections/lips` to export just that collection. Each product keeps its variants, prices, compare-at prices, SKUs, availability and images.

### How to scrape WooCommerce products without an API key

WooCommerce 4+ stores expose the public Store API (`/wp-json/wc/store/v1/products`), which needs no API key or login. The Actor detects WooCommerce automatically (or set `platform` to `woocommerce`), converts prices from minor units and attaches the store currency. Turn on `fetchWooVariations` for per-variation prices, SKUs and stock.

### Export Shopify products to CSV or Excel

Every product is one row with variants nested, so the dataset exports cleanly from the Output tab or API as CSV, Excel, JSON or XML. Shopify and WooCommerce products use the same columns, so you can mix stores in one sheet.

### Monitor competitor prices and stock on Shopify and WooCommerce

Schedule the Actor daily on the same store URLs and compare `price`, `compare_at_price`, `on_sale` and `in_stock` by `product_id` between runs. Use `onlyInStock` to skip sold-out products, and send results to Google Sheets, Slack or a webhook with Apify integrations.

### Why doesn't a store work?

Some stores disable `products.json` or the Store API, or disallow the endpoint in robots.txt. The Actor respects that: the store is skipped, its reason appears in the `OUTPUT` summary, and you are not charged for it.

### Use cases

- **Competitor price monitoring** — schedule daily runs and diff prices and stock
- **Market and assortment research** — compare catalogs, price points and brands across stores
- **Dropshipping and resellers** — keep supplier catalogs in sync
- **Lead generation for e-commerce services** — catalog size, price range and platform per store
- **AI shopping agents and RAG** — clean product data with stable IDs and URLs

### Ready-made example tasks

Open one, check the prefilled input, and run it in one click:

- [Export all Shopify store products to JSON](https://apify.com/henryklimes/ecommerce-products-feed/examples/shopify-store-products-to-json)
- [Track competitor prices on Shopify stores](https://apify.com/henryklimes/ecommerce-products-feed/examples/track-competitor-prices-shopify)
- [Export WooCommerce products with prices](https://apify.com/henryklimes/ecommerce-products-feed/examples/woocommerce-products-export)

### Pricing

Pay per result: **$1.00 per 1,000 products** ($0.001 per product). Stores that can't be read cost nothing. Use `maxProducts` to cap spend.

### FAQ

**Which stores work?** Most Shopify stores expose `products.json`, and WooCommerce stores (WooCommerce 4+) expose the Store API. Stores that disable these endpoints or disallow them in robots.txt are reported in the summary and skipped.

**Why is `in_stock` null?** Some stores hide inventory. Shopify reports availability per variant; WooCommerce reports it per product (and per variation with `fetchWooVariations`).

**Why are WooCommerce variant prices empty?** The Store API lists variations without prices. Turn on `fetchWooVariations` to fetch them (one extra request each). The product's `price_min`/`price_max` are always filled.

**Does it collect personal data?** No. It reads public product catalogs only.

### Support

Report issues or request a platform in the Issues tab of this Actor.

# Actor input Schema

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

Store homepages (e.g. colourpop.com) or Shopify collection URLs (…/collections/mens). The platform is detected automatically.

## `platform` (type: `string`):

Force a platform or let the Actor detect it

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

Include plain-text product descriptions

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

Skip products where no variant is available

## `fetchWooVariations` (type: `boolean`):

Fetch each WooCommerce variation for its own price, SKU and stock (one extra request per variation, max 500 per page of products). Shopify always includes variants.

## `maxProducts` (type: `integer`):

Cap on products across all stores. Prefill is a small first-run cap; remove it to export the full catalog.

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

Cap per store. Prefill keeps a first Store run small; remove it to get every product from each store.

## `pageDelayMs` (type: `integer`):

Pause between catalog pages to stay polite to the store

## Actor input object example

```json
{
  "storeUrls": [
    "https://www.allbirds.com",
    "https://colourpop.com"
  ],
  "platform": "auto",
  "includeDescription": true,
  "onlyInStock": false,
  "fetchWooVariations": false,
  "maxProducts": 50,
  "maxProductsPerStore": 25,
  "pageDelayMs": 500
}
```

# Actor output Schema

## `products` (type: `string`):

Normalized products with variants

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

Per-store platform, counts and errors

# 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://www.allbirds.com",
        "https://colourpop.com"
    ],
    "maxProducts": 50,
    "maxProductsPerStore": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("henryklimes/ecommerce-products-feed").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://www.allbirds.com",
        "https://colourpop.com",
    ],
    "maxProducts": 50,
    "maxProductsPerStore": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("henryklimes/ecommerce-products-feed").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://www.allbirds.com",
    "https://colourpop.com"
  ],
  "maxProducts": 50,
  "maxProductsPerStore": 25
}' |
apify call henryklimes/ecommerce-products-feed --silent --output-dataset

```

## MCP server setup

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

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/NxPeLsKePM7sDV8Jt/builds/kqMLGppU2DSPEbVyk/openapi.json
