Ecwid Store Scraper - Extract Products from 4M+ Lightspeed Ecwid Stores

Scrape products, prices, inventory, variants, and categories from any Ecwid-powered online store. Ecwid (now Lightspeed) powers over 4 million stores worldwide. Extract complete product catalogs for competitor monitoring, price intelligence, market research, and e-commerce data collection.

Built by John Rippy (LinkedIn | Website)

---

IMPORTANT: Demo Mode is ON by default. You will get fake sample data until you turn it off. Set demoMode to false in your input to scrape real Ecwid stores. If you see products like "Premium Wireless Headphones (DEMO)" or "Leather Phone Case (DEMO)" in your results, demo mode is still on.

---

Quick Start

Step 1: Set demoMode to false

Step 2: Provide a store URL or store ID

Step 3: Run the actor

{
  "demoMode": false,
  "storeUrl": "https://example-store.com/shop",
  "maxProducts": 100
}

---

Features

• Automatic Store Detection — Just provide the store URL, we find the store ID
• Complete Product Data — Name, price, SKU, stock status, images, descriptions
• Variant Extraction — All sizes, colors, and option combinations
• Category Hierarchy — Full category tree with parent-child relationships
• Price Intelligence — Current price, compare-at price, sale detection
• Inventory Tracking — Stock status, quantity, unlimited flags
• Multiple Scraping Methods — API-first with HTML fallback for maximum reliability
• Handles Large Catalogs — Pagination for stores with 10,000+ products
• Image URLs — Thumbnail and full-size image links

---

Input Examples

Scrape by Store URL

{
  "demoMode": false,
  "storeUrl": "https://example-store.com/shop",
  "maxProducts": 500,
  "includeVariants": true,
  "includeCategories": true
}

Scrape by Store ID

{
  "demoMode": false,
  "storeId": "12345678",
  "maxProducts": 1000,
  "includeVariants": true,
  "includeCategories": true
}

Price Monitoring (Minimal Data)

{
  "demoMode": false,
  "storeUrl": "https://competitor-store.com",
  "maxProducts": 200,
  "includeVariants": false,
  "includeCategories": false
}

Full Catalog Export

{
  "demoMode": false,
  "storeUrl": "https://my-ecwid-store.com",
  "maxProducts": 10000,
  "includeVariants": true,
  "includeCategories": true
}

---

How to Find Store ID

If you already know the Ecwid store ID, you can provide it directly (skips auto-detection):

1. Open the Ecwid store in your browser
2. Open Developer Tools (F12)
3. Go to Console tab
4. Type: Ecwid.getOwnerId()
5. Press Enter — the store ID will be displayed

Alternatively, view page source and search for storeId or data-store. Most of the time you can just provide the URL and the scraper will detect it automatically.

---

Input Parameters

Parameter	Type	Default	Description
demoMode	boolean	true	⚠️ Set to false for real data. Returns fake sample data when true.
storeUrl	string	—	URL of the Ecwid store to scrape*
storeId	string	—	Ecwid store ID if known*
maxProducts	number	1000	Maximum products to scrape
includeVariants	boolean	true	Include product variants (sizes, colors, etc.)
includeCategories	boolean	true	Include category data

*Either storeUrl or storeId is required (when demoMode is off)

---

Output Format

Product Output

{
  "id": 123456789,
  "sku": "PROD-001",
  "name": "Premium Wireless Headphones",
  "url": "https://store.ecwid.com/#!/~/product/id=123456789",
  "price": 149.99,
  "compareToPrice": 199.99,
  "thumbnailUrl": "https://d2j6dbq0ber.cloudfront.net/...",
  "imageUrl": "https://d2j6dbq0ber.cloudfront.net/...",
  "description": "High-quality wireless headphones with noise cancellation...",
  "inStock": true,
  "quantity": 50,
  "unlimited": false,
  "weight": 0.5,
  "categoryIds": [1001, 1002],
  "categories": ["Electronics", "Audio"],
  "options": [
    {
      "name": "Color",
      "choices": ["Black", "White", "Blue"],
      "type": "SELECT"
    }
  ],
  "variants": [
    {
      "id": 987654321,
      "sku": "PROD-001-BLK",
      "price": 149.99,
      "quantity": 20,
      "options": { "Color": "Black" }
    }
  ],
  "enabled": true,
  "created": "2025-01-15T10:30:00Z",
  "updated": "2026-01-20T14:45:00Z"
}

Store Info (Key-Value Store)

{
  "storeId": "12345678",
  "storeName": "Example Electronics Store",
  "storeUrl": "https://example-store.com",
  "productsCount": 847,
  "categoriesCount": 24,
  "scrapedAt": "2026-01-28T10:30:00.000Z"
}

---

Common Use Cases

Competitor Price Monitoring

{
  "demoMode": false,
  "storeUrl": "https://competitor-store.com",
  "maxProducts": 200,
  "includeVariants": true,
  "includeCategories": false
}

Run weekly to track competitor pricing changes.

Market Research

{
  "demoMode": false,
  "storeUrl": "https://industry-leader.com",
  "maxProducts": 1000,
  "includeVariants": true,
  "includeCategories": true
}

Analyze product offerings, pricing strategies, and catalog structure.

Inventory Monitoring

{
  "demoMode": false,
  "storeUrl": "https://supplier-store.com",
  "maxProducts": 500,
  "includeVariants": false,
  "includeCategories": false
}

Monitor supplier stock levels and availability.

---

Pricing

Event	Price
product_scraped	$0.001 per product

Demo mode is free. Example: 500 products = $0.50.

---

Troubleshooting

Problem	Solution
Getting fake data ("Premium Wireless Headphones (DEMO)", etc.)	Set demoMode to false. This is the #1 issue.
"Store not found" error	Verify the URL is an actual Ecwid store. Try providing the store ID directly.
0 products returned	Store may require authentication. Try the URL in a browser to confirm products are visible.
Incomplete product data	Some fields may be empty if not set by the merchant. Variant data requires includeVariants: true.
Slow scraping	Large catalogs (10,000+ products) take longer. Reduce maxProducts for testing.

---

Built by John Rippy | Actor Arsenal