# Ecwid App Market Scraper (`crawlerbros/ecwid-app-market-scraper`) Actor

Scrape apps from the Ecwid (Lightspeed E-Series) App Market with name, developer, description, categories, pricing, ratings, and icon.

- **URL**: https://apify.com/crawlerbros/ecwid-app-market-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Developer tools, E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Ecwid App Market Scraper

Scrape the [Ecwid (Lightspeed E-Series) App Market](https://www.ecwid.com/apps) to extract apps with name, developer, description, categories, pricing type, and icon URL.

### Features

- **Browse all apps** — scrape the complete app marketplace (300+ apps)
- **Filter by category** — Shipping, Marketing, Analytics, Accounting, Dropshipping, and more
- **Search by keyword** — filter apps by name, description, or developer
- **Free apps only filter** — optionally return only free apps
- No authentication or proxy required

### Data Source

App data is embedded as JavaScript in the Ecwid marketplace pages (`ecwid.com/apps/<category>`). The scraper parses this server-rendered data directly — no browser automation needed.

### Input

| Field | Type | Description | Default |
|-------|------|-------------|---------|
| `mode` | Select | `browse` (all), `byCategory`, or `search` | `browse` |
| `category` | Select | Category slug for `byCategory` mode | — |
| `searchQuery` | Text | Keyword for `search` mode | — |
| `includeFreeOnly` | Boolean | Return only free apps | `false` |
| `maxItems` | Number | Maximum apps to return (1–500) | `50` |

#### Categories

| Slug | Label |
|------|-------|
| `featured` | Featured |
| `marketing` | Marketing |
| `shipping` | Shipping |
| `analytics` | Analytics & Reporting |
| `accounting` | Accounting |
| `dropshipping` | Dropshipping |
| `tools` | Tools |
| `store-design` | Store Design |
| `selling-on-marketplaces` | Selling on Marketplaces |
| `customer-support` | Customer Support & Rewards |

### Output

| Field | Type | Description |
|-------|------|-------------|
| `appId` | String | Unique app namespace/slug |
| `name` | String | App name |
| `tagline` | String | Short description |
| `description` | String | Full description (may contain HTML) |
| `developer` | String | Developer/company name |
| `categories` | Array | App categories |
| `pricingType` | String | `free`, `paid`, or `freemium` |
| `pricing` | String | Human-readable pricing string |
| `url` | String | App marketplace page URL |
| `iconUrl` | String | App icon URL |
| `headerImageUrl` | String | App header/banner image URL |
| `scrapedAt` | String | ISO 8601 timestamp |

#### Sample Output

```json
{
  "appId": "shipstation",
  "name": "ShipStation: Shipping Automation",
  "tagline": "The fastest, easiest way to get products to your customers",
  "description": "<p>Shipping doesn't have to be time-consuming or costly...</p>",
  "developer": "ShipStation",
  "categories": ["Catalog & Order Management", "Shipping"],
  "pricingType": "paid",
  "pricing": "Billed Externally",
  "url": "https://www.ecwid.com/apps/featured/shipstation",
  "iconUrl": "https://djqizrxa6f10j.cloudfront.net/apps/thirdparty/shipstation/icon.png",
  "headerImageUrl": "https://d35z3p2poghz10.cloudfront.net/apps/thirdparty/shipstation/header.png",
  "scrapedAt": "2026-05-22T10:00:00+00:00"
}
````

### FAQ

**How many apps does Ecwid have?**
Ecwid's App Market has 300–400 apps across 10+ categories.

**Does this require an Ecwid account?**
No. App data is publicly accessible on the Ecwid website.

**What is "Billed Externally"?**
This means the app has its own pricing page and is billed directly by the developer — not through the Ecwid marketplace.

**How is `pricingType` determined?**

- `free`: App is marked as totally free OR pricing says "Free"
- `freemium`: Pricing includes "free trial" or tiered pricing starting from free
- `paid`: All other paid apps

**What is Ecwid / Lightspeed E-Series?**
Ecwid was acquired by Lightspeed Commerce and rebranded as Lightspeed E-Series. The marketplace URL remains `ecwid.com/apps`.

# Actor input Schema

## `mode` (type: `string`):

Browse all apps, filter by category, or search by keyword.

## `category` (type: `string`):

App market category. Accepts slugs or display names (e.g. 'marketing', 'shipping', 'tools', 'store management', 'store-design', 'analytics', 'accounting', 'dropshipping', 'selling-on-marketplaces', 'customer-support', 'featured').

## `searchQuery` (type: `string`):

Keyword to filter apps by name or description (used when mode is 'search').

## `includeFreeOnly` (type: `boolean`):

If true, only return apps marked as totally free.

## `maxItems` (type: `integer`):

Maximum number of apps to return (1–500).

## Actor input object example

```json
{
  "mode": "browse",
  "includeFreeOnly": false,
  "maxItems": 50
}
```

# Actor output Schema

## `items` (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 = {
    "mode": "browse",
    "includeFreeOnly": false,
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/ecwid-app-market-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 = {
    "mode": "browse",
    "includeFreeOnly": False,
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/ecwid-app-market-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "browse",
  "includeFreeOnly": false,
  "maxItems": 50
}' |
apify call crawlerbros/ecwid-app-market-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/ecwid-app-market-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Ecwid App Market Scraper",
        "description": "Scrape apps from the Ecwid (Lightspeed E-Series) App Market with name, developer, description, categories, pricing, ratings, and icon.",
        "version": "1.0",
        "x-build-id": "rS2TJOtFRheDgNWDL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~ecwid-app-market-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-ecwid-app-market-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/crawlerbros~ecwid-app-market-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-ecwid-app-market-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/crawlerbros~ecwid-app-market-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-ecwid-app-market-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "mode": {
                        "title": "Scrape Mode",
                        "enum": [
                            "browse",
                            "byCategory",
                            "search"
                        ],
                        "type": "string",
                        "description": "Browse all apps, filter by category, or search by keyword.",
                        "default": "browse"
                    },
                    "category": {
                        "title": "Category",
                        "type": "string",
                        "description": "App market category. Accepts slugs or display names (e.g. 'marketing', 'shipping', 'tools', 'store management', 'store-design', 'analytics', 'accounting', 'dropshipping', 'selling-on-marketplaces', 'customer-support', 'featured')."
                    },
                    "searchQuery": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Keyword to filter apps by name or description (used when mode is 'search')."
                    },
                    "includeFreeOnly": {
                        "title": "Free Apps Only",
                        "type": "boolean",
                        "description": "If true, only return apps marked as totally free.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of apps to return (1–500).",
                        "default": 50
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```