# Shopify Store Products Scraper (`properscraper/shopify-store-products-scraper`) Actor

Export the full product catalogue of any Shopify store: prices, variants, stock availability, images and descriptions. Reads the public product feed of the store, up to 250 products per request, with no login or browser.

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

## Pricing

from $0.50 / 1,000 product saveds

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 Store Products Scraper

Export the full product catalogue of any Shopify store. Give it a store's address and it returns every product with prices, variants, stock availability, images and descriptions.

It reads the public product feed that Shopify stores publish (`/products.json`), so it needs no login and no browser, and gets up to 250 products per request.

Use it to:

- monitor competitors' prices, discounts and new products
- check which products and sizes are in or out of stock
- build a product database or price comparison for a niche
- migrate or back up a catalogue

### Input

| Field | What it does |
|---|---|
| **Shopify stores** | One per line. A store's domain (`allbirds.com`) or any URL on the store. Use a collection URL (`https://allbirds.com/collections/mens`) to export just that collection. |
| **Maximum products per store** | Stop after this many matching products per store. 0 means no limit. |
| **Product title contains** | Keep only products whose title contains one of these words or phrases. |
| **In stock only** | Keep only products with at least one variant available. |
| **On sale only** | Keep only products priced below their compare-at price. |
| **Updated on or after** | Keep only products the store has updated since this date. |
| **Include product descriptions** | Adds the description as plain text and HTML. On by default. |

```json
{
    "stores": ["allbirds.com", "https://example-store.com/collections/sale"],
    "onlyAvailable": true,
    "maxProductsPerStore": 500
}
```

### Output

One record per product, with its variants nested inside:

```json
{
    "store": "allbirds.com",
    "storeName": "Allbirds",
    "currency": "USD",
    "productId": "7292464824400",
    "title": "Women's Wool Cruiser - Port (Port Sole)",
    "handle": "womens-wool-cruiser-port-port-sole",
    "url": "https://www.allbirds.com/products/womens-wool-cruiser-port-port-sole",
    "vendor": "Allbirds",
    "productType": null,
    "tags": ["11/3/26 DROP", "DNAM BRANDS"],
    "available": true,
    "price": 120,
    "priceMax": 120,
    "compareAtPrice": null,
    "onSale": false,
    "variantCount": 13,
    "variants": [
        {
            "variantId": "41990816137296",
            "title": "5",
            "sku": "A12858W050",
            "price": 120,
            "compareAtPrice": null,
            "available": false,
            "options": { "Size": "5" },
            "grams": 1000,
            "imageUrl": null
        }
    ],
    "options": [{ "name": "Size", "values": ["5", "5.5", "6"] }],
    "imageUrl": "https://cdn.shopify.com/s/files/1/1104/4168/files/A12858W090-PORT_SIDE_TRANSPARENT.png?v=1793836076",
    "images": ["https://cdn.shopify.com/s/files/1/1104/4168/files/A12858W090-PORT_SIDE_TRANSPARENT.png?v=1793836076"],
    "createdAt": "2026-02-05T01:37:18.000Z",
    "publishedAt": "2026-11-04T23:48:27.000Z",
    "updatedAt": "2026-11-11T16:17:35.000Z",
    "descriptionText": "Innovation meets individuality in the Wool Cruiser ...",
    "descriptionHtml": "<p>Innovation meets individuality in the Wool Cruiser ...</p>",
    "scrapedAt": "2026-11-11T16:30:00.000Z"
}
```

- `price` is the lowest variant price and `priceMax` the highest. `compareAtPrice` is the highest "was" price among the variants, and `onSale` is true when it is above `price`.
- `available` is true when at least one variant can be bought.
- `storeName` and `currency` come from the store's public shop details. A few stores do not publish them, in which case both are `null`.

A `SUMMARY` record in the run's key-value store lists, for each store, its name, how many products it reports having, how many were saved, and any error.

### Pricing

Pay per result. You are charged once for each product saved to the dataset, at the per-result price shown on this page. Variants are included in the product at no extra charge.

You are not charged for products removed by your filters or for stores that cannot be read. The run stops as soon as it reaches the maximum charge you set for it.

### Limits

- Only Shopify stores are supported. For anything else the run reports that the site has no product feed.
- A store can switch its product feed off or put the whole shop behind a password. Those stores cannot be read, and the Actor does not try to get around that.
- Shopify lets the feed be read up to 25,000 products deep. For a larger store, export it collection by collection using collection URLs.
- Stock is reported as available or not per variant. Shopify's public feed does not include stock quantities.
- If a store asks the Actor to slow down, it waits and carries on, so a very large store can take a few minutes.

### Is this allowed?

The Actor reads only the product feed a store publishes openly, without logging in, at a gentle pace. It collects product information, not personal data. You are responsible for how you use the data.

# Actor input Schema

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

One per line. A store's domain (allbirds.com) or any URL on the store. To export one collection only, use its URL (https://allbirds.com/collections/mens).

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

Stop after this many matching products for each store. 0 means no limit.

## `titleKeywords` (type: `array`):

Only keep products whose title contains at least one of these words or phrases. Not case sensitive. Leave empty for all products.

## `onlyAvailable` (type: `boolean`):

Only keep products with at least one variant available to buy.

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

Only keep products whose price is below their compare-at price.

## `updatedAfter` (type: `string`):

Only keep products the store updated on or after this date (YYYY-MM-DD). Useful for tracking changes between runs.

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

Add the full product description as plain text and as HTML. Turn off for smaller results.

## Actor input object example

```json
{
  "stores": [
    "allbirds.com"
  ],
  "maxProductsPerStore": 0,
  "onlyAvailable": false,
  "onlyOnSale": false,
  "includeDescription": true
}
```

# Actor output Schema

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

Every product saved by the run, one record per product with its variants.

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

Totals for the run and, for each store, how many results were saved and any error.

# 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": [
        "allbirds.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("properscraper/shopify-store-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": ["allbirds.com"] }

# Run the Actor and wait for it to finish
run = client.actor("properscraper/shopify-store-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": [
    "allbirds.com"
  ]
}' |
apify call properscraper/shopify-store-products-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,properscraper/shopify-store-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/9j7xZUbDtbHeX0OdA/builds/03R4kgaLFJ9FZpaR8/openapi.json
