# Shopify Products Scraper - Prices, Variants & Stock (`eliai/shopify-products-scraper`) Actor

Scrape every product from any Shopify store: title, vendor, type, tags, price range, compare-at/sale price, variants with SKU and stock, images and dates. One row per product, bulk stores, keyword/price/stock filters. No API key. $0.001 per product.

- **URL**: https://apify.com/eliai/shopify-products-scraper.md
- **Developed by:** [Broke to Built](https://apify.com/eliai) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 scraped products

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

## Shopify Products Scraper — every product, price, variant and stock flag from any Shopify store

Pull the full public catalog of any **Shopify** store: product title, vendor, product type, tags, **price range, compare-at (sale) price and discount %**, every variant with SKU, price and **in-stock flag**, images, and created/updated/published dates. One row per product, up to 50 stores per run, with keyword, vendor, type, price, in-stock and on-sale filters. **No API key, no login, no proxy.** $0.001 per product.

### Real output (run `XNWuN6EJWbtSoXe8r`, 10 products)

Input: `{"stores":["www.allbirds.com","https://kyliecosmetics.com","example.com"],"keywords":["runner","lip"],"maxProductsPerStore":5}`

| store | product | type | price (USD) | variants | in stock |
|---|---|---|---|---|---|
| www.allbirds.com | Men's Strider - Medium Grey (Blizzard Sole) | Shoes | 130 | 13 | yes |
| www.allbirds.com | Men's Tree Dasher 2 - Natural Black (Blizzard Sole) | Shoes | 140 | 13 | no |
| www.allbirds.com | Women's Cruiser Slip On Canvas - Sea Spray (Natural White Sole) | Shoes | 100 | 13 | yes |
| kyliecosmetics.com | Cosmic Kylie Jenner Intense & Lip Butter Gift Set | Set | 68 | 1 | yes |
| kyliecosmetics.com | Plumping Matte Lip Kit | Lip Kit | 35 | 4 | yes |

`example.com` is not a Shopify store, so it came back as one uncharged `ok:false` record saying so.

```json
{
  "ok": true,
  "storeDomain": "www.allbirds.com",
  "storeName": "Allbirds",
  "currency": "USD",
  "productId": "7218356060240",
  "title": "Men's Strider Explore - Natural Black (Dark Grey Sole)",
  "handle": "mens-strider-explore",
  "url": "https://www.allbirds.com/products/mens-strider-explore",
  "vendor": "Allbirds",
  "productType": "Shoes",
  "priceMin": 130,
  "priceMax": 130,
  "compareAtPriceMax": null,
  "onSale": false,
  "discountPercent": null,
  "available": false,
  "variantsCount": 13,
  "variantsAvailable": 0,
  "options": [{ "name": "Size", "values": ["8", "8.5", "9", "…"] }],
  "variants": [
    { "id": "41334293889104", "title": "8", "sku": "A11768M080", "price": 130, "compareAtPrice": null, "available": false, "grams": 919 }
  ],
  "imageUrl": "https://cdn.shopify.com/s/files/1/1104/4168/files/A11768_25Q4_Strider-Explore-Natural-Black-Dark-Grey-Sole_PDP_LEFT.png?v=1759336475",
  "publishedAt": "2026-08-26T10:22:14-07:00",
  "createdAt": "2025-09-10T12:47:47-07:00",
  "updatedAt": "2026-09-24T13:39:13-07:00"
}
```

### What people use it for

- **Competitor price monitoring**: run a rival's store on a schedule and diff `priceMin`, `onSale` and `available`.
- **Sale and discount tracking**: `onSaleOnly: true` returns only products whose compare-at price is above the selling price, with `discountPercent`.
- **Stock-out alerts**: `variantsAvailable` and each variant's `available` flag show what is sold out, size by size.
- **Catalog migration and feeds**: export a store's whole catalog to CSV or JSON, with SKUs and images.
- **Market research and lead lists**: pull many stores at once and group by `vendor`, `productType` and price band.

### Input

| field | what it does |
|---|---|
| `store` | One store: a domain (`www.allbirds.com`) or any URL on the store. Default `www.allbirds.com`. |
| `stores` | Up to 50 stores in one run. When you pass `stores`, the single `store` field is ignored. |
| `maxProductsPerStore` | Cap on rows per store, applied after filters. Default 100, max 25,000. |
| `keywords` | Keep products whose title, tags or type contain any of these words. |
| `vendor` / `productType` | Keep products whose vendor or type contains this text. |
| `minPrice` / `maxPrice` | Keep products with a variant inside this price range (store currency). |
| `inStockOnly` / `onSaleOnly` | Keep only available products / only discounted products. |
| `includeDescription` | Adds the product description as plain text. |

### Pricing

**$0.001 per product row** (pay-per-event `product-scraped`). 1,000 products cost $1.00. Sites that are not Shopify, stores that block the request and filters that match nothing each produce one `ok:false` record and are **not charged**.

### How it works and limits

It reads the store's public `/products.json` catalog endpoint (the same JSON Shopify's own storefront uses) and `/meta.json` for the store name and currency. Nothing is logged into and no browser is launched, so runs are fast and cheap.

- Works on stores running Shopify with the public catalog enabled. A few large stores block automated requests (for example, gymshark.com answers HTTP 403); you get an honest uncharged error for those.
- Prices are the store's default-currency storefront prices. Inventory **quantities** are not public on Shopify; you get an in-stock flag per variant.
- Only published products are visible. Draft and hidden products are not in the public catalog.

### FAQ

**Do I need a Shopify API key or store access?** No. It reads data every Shopify storefront publishes.

**How do I know a site is on Shopify?** Just add it. If it is not, you get one uncharged record that says so.

**Can I scrape a single collection?** Pass the store and use `keywords`, `productType` or `vendor` to narrow it down.

### Changelog

- **0.1** (2026-09-24): first release. One row per product, bulk stores, sale/stock/price filters, store currency.

# Actor input Schema

## `store` (type: `string`):

A Shopify store domain or URL, e.g. www.allbirds.com or https://www.gymshark.com.

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

Several stores in one run, up to 50. Domains or URLs.

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

Cap on rows per store after filters. You are charged per product returned.

## `keywords` (type: `array`):

Keep only products whose title, tags or type contain ANY of these words (case-insensitive). Empty = all products.

## `vendor` (type: `string`):

Keep only products whose vendor contains this text.

## `productType` (type: `string`):

Keep only products whose product type contains this text, e.g. Shoes.

## `minPrice` (type: `integer`):

Keep only products with a variant priced at or above this (store currency).

## `maxPrice` (type: `integer`):

Keep only products with a variant priced at or below this (store currency).

## `inStockOnly` (type: `boolean`):

Keep only products with at least one available variant.

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

Keep only products where a variant's compare-at price is above its price.

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

Adds the product description as clean plain text. Larger output.

## Actor input object example

```json
{
  "store": "www.allbirds.com",
  "stores": [],
  "maxProductsPerStore": 100,
  "keywords": [],
  "inStockOnly": false,
  "onSaleOnly": false,
  "includeDescription": false
}
```

# Actor output Schema

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

Every product row this run produced, as JSON.

## `resultsCsv` (type: `string`):

The same rows as a spreadsheet-ready CSV.

# 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 = {
    "store": "www.allbirds.com",
    "stores": [],
    "maxProductsPerStore": 100,
    "keywords": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("eliai/shopify-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 = {
    "store": "www.allbirds.com",
    "stores": [],
    "maxProductsPerStore": 100,
    "keywords": [],
}

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

```

## MCP server setup

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