# Momo Shopping Scraper: Taiwan Products, Prices & Stock (`niches/momo-shopping-scraper`) Actor

Product name, brand, price, market price, stock, rating, sales badge, image and link from Momo Shopping (momoshop.com.tw) in Taiwan. Search in Chinese or English, up to 500 products a search, with free price tracking.

- **URL**: https://apify.com/niches/momo-shopping-scraper.md
- **Developed by:** [Niches](https://apify.com/niches) (community)
- **Categories:** E-commerce, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.20 / 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.
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

## Momo Shopping Scraper: Taiwan Products, Prices & Stock

Search **Momo Shopping** (**momoshop.com.tw**), one of Taiwan's biggest online stores, and get one clean row per product: name, brand, selling price and market price in TWD, stock quantity, star rating and rating count, Momo's total-sales badge, the promotion line, an Ad flag for sponsored placements, image and the canonical product link.

Send up to 20 searches in one run, in Traditional Chinese or English, with up to 500 products each. Schedule it to track prices: every row says whether its price dropped or rose since your last run, and the history stays in your own Apify account.

Tested in Apify's cloud. The example below is a real delivered cloud row.

### What you get

| Field | What it holds |
|---|---|
| productId / productName / brand | Momo product code (TP... for marketplace sellers), the full product name and the brand label from its 【】 brackets. |
| price / regularPrice / currency / onSale | Selling price and market (list) price in TWD, and whether the product is discounted. |
| subtitle | The line under the product name: often a promotion such as 滿1件折1079 (NT$1,079 off one item). |
| stockCount / inStock / availability | Stock quantity Momo reports, and whether it is above zero. |
| rating / reviewCount | Average star rating (out of 5) and the number of ratings. |
| salesVolumeText / salesVolumeMin | Momo's total-sales badge as shown (總銷量>3,000) and its number (3000; 萬 = 10,000). |
| isSponsored / rank / searchTerm | Whether the result is a paid Ad placement, its position in the results and the search that found it. |
| productUrl / image | Product page link (momoshop.com.tw/product/... for Momo's own products, the seller's page for marketplace products) and main image. |
| priceStatus / previousPrice / priceChange / priceChangePercent / firstSeenAt | Comparison with your previous run: first-seen, unchanged, dropped or raised. |
| scrapedAt / sourceUrl | When the row was read (UTC) and the Momo results page it came from. |

### What people use it for

- **Price monitoring:** Run the same searches daily or weekly and get every price drop and rise, with the biggest moves listed in SUMMARY.
- **Market and competitor research:** Compare brands, prices, discounts, ratings and sales badges across a whole Momo category.
- **Stock and promotion tracking:** Watch stock quantities, promotion lines and sponsored placements change over time.
- **Automation and analysis:** Feed one consistent JSON, CSV or Excel table into spreadsheets, dashboards or AI workflows.

### How to use it

1. Enter one or more search words: Traditional Chinese works best, and English brand or model names also work. The example searches for laptops (筆記型電腦).
2. Choose the maximum products per search (Momo shows 30 a page) and, if you like, a maximum cost per run.
3. Run the Actor, then open the dataset for product rows and the SUMMARY record for counts per search.
4. Run it again later (or on a schedule) with the same trackingName to see which prices changed.

### Input

| Field | Example | Notes |
|---|---|---|
| searches | \["筆記型電腦"] | Up to 20 search words or phrases, one per line. |
| maxProductsPerSearch | 20 | 1 to 500 products for each search; an upper limit, not a guaranteed count. |
| trackPrices | true | Compare each price with your last run (free). |
| trackingName | daily-laptops | Optional name for a separate price history. |

### Output

Each result is one row in the run's dataset (download it as JSON, CSV, Excel, XML or HTML, or read it through the API). An example row (values shortened):

```json
{
  "resultId": "7b0c8fbc8a2f7070ac0a4ac4d289e584",
  "productId": "15164867",
  "site": "Momo Shopping",
  "country": "Taiwan",
  "productName": "【Acer 宏碁】15.6吋十核Core 5 16G輕薄筆電(Aspire Lite/AL15-53P-58UB/Core 5-120U/16G/512G/W11)",
  "brand": "Acer 宏碁",
  "price": 22811,
  "regularPrice": 24900,
  "currency": "TWD",
  "onSale": true,
  "subtitle": "滿1件折1089",
  "rating": null,
  "reviewCount": null,
  "salesVolumeText": "總銷量>100",
  "salesVolumeMin": 100,
  "stockCount": 98,
  "inStock": true,
  "availability": "in_stock",
  "image": "https://img3.momoshop.com.tw/goodsimg/0015/164/867/15164867_OL.jpg?t=1777989242",
  "productUrl": "https://www.momoshop.com.tw/product/15164867",
  "rank": 1,
  "searchTerm": "筆記型電腦",
  "isSponsored": true,
  "previousPrice": null,
  "priceChange": null,
  "priceChangePercent": null,
  "priceStatus": "first-seen",
  "firstSeenAt": "2026-11-12T18:17:34Z",
  "scrapedAt": "2026-11-12T18:17:34Z",
  "sourceUrl": "https://www.momoshop.com.tw/search/%E7%AD%86%E8%A8%98%E5%9E%8B%E9%9B%BB%E8%85%A6?curPage=1&viewport=desktop"
}
```

The free `SUMMARY` record in the run's key-value store lists the products delivered for each search, searches that found nothing, the price-change counts with the biggest drops and rises, what was charged and the requests the run made.

### Pricing

- **$0.004 per delivered product ($4 per 1,000 products)** on the Free and Starter plans, $0.0036 on Silver and $0.0032 on Gold.
- Apify's start fee is $0.00005 per run. Empty searches, failed requests, duplicates and SUMMARY have no product or record charge.

What typical jobs cost at the list price:

| Job | Cost |
|---|---|
| One search, 20 products | about $0.08 |
| 10 searches, 100 products each (1,000 products) | about $4.00 |
| Daily check of 50 products for a month (1,500 products) | about $6.00 |
| A search with no results | $0.00005 (start fee only) |

Set **Maximum cost per run** in the Apify Console (or `maxTotalChargeUsd` in the API). The Actor checks the budget before each product and stops cleanly when it is reached: you are charged only for products delivered.

### Tips

- Search the way Taiwanese shoppers do: Traditional Chinese category words (筆記型電腦, 吹風機, 衛生紙) return the fullest results.
- Sponsored (Ad) products can appear at the top of the results; filter on isSponsored to keep only organic rankings.
- Reuse trackingName on scheduled runs to compare with the last run; use another name for a separate watch list.
- Read SUMMARY for counts per search, searches that found nothing and the biggest price moves.

### Use it through the API

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("niches/momo-shopping-scraper").call(run_input={"searches": ["筆記型電腦"], "maxProductsPerSearch": 20})
for row in client.dataset(run.default_dataset_id).iterate_items():
    print(row)
```

**JavaScript**

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('niches/momo-shopping-scraper').call({"searches": ["筆記型電腦"], "maxProductsPerSearch": 20});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

**HTTP (one call, results back)**

```bash
curl -X POST 'https://api.apify.com/v2/acts/niches~momo-shopping-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"searches": ["筆記型電腦"], "maxProductsPerSearch": 20}'
```

### Integrations and schedules

- **Schedules:** run it every hour, day or week from the Apify Console (Schedules) and keep a history of results.
- **Make, Zapier, n8n, Google Sheets, Slack, Airtable:** connect it through Apify's integrations, or send each finished run to a **webhook**.
- **Datasets:** results stay in the run's dataset; export them or read them by API whenever you need them.

### Use it with AI agents (MCP)

Add Apify's MCP server with this Actor already pinned (`https://mcp.apify.com?tools=niches/momo-shopping-scraper`) to Claude, ChatGPT, Cursor, VS Code or any MCP client. The agent can find this Actor and run it for you: ask it for product prices, stock, ratings and sales badges from Momo Shopping in Taiwan. AI agents can also pay for runs directly through Apify's agentic payments.

### Limits

- Reads Momo's public, signed-out search results. It does not log in, and it does not solve or get around access checks; if Momo cannot be read, the run says so in its status message and SUMMARY.
- Prices are in New Taiwan dollars as shown in search results. Coupons, member discounts, promotions at checkout and shipping are not applied.
- Stock quantities and sales badges are what Momo publishes in search results. salesVolumeMin is a lower bound, not an exact count, and on some bundle listings (a laptop with a bag and mouse, for example) Momo's badge is far higher than the rating count suggests.
- A product found again (by a second search, or repeated on a later results page) is delivered and charged once per run; its first search supplies searchTerm and rank.
- At most 20 searches a run and 500 products a search (Momo shows 30 products a page).
- brand is the label in the product name's 【】 brackets; it is null when the name has none.

### FAQ

**Do I need a Momo account or API key?**

No. It reads public, signed-out search results.

**Can I search in English?**

Yes. Brand and model names in English work; for categories, Traditional Chinese words return the fullest results.

**Why is rating null on some products?**

Sponsored placements and products without ratings carry no star rating. reviewCount is 0 when a product has no ratings yet.

**How does price tracking work?**

Keep trackPrices on and reuse trackingName. Each delivered product is compared with the price saved on your previous run; only delivered products update the history, which lives in your own key-value store.

**Does a search return every product?**

It returns up to your maximum (500 at most) in Momo's own ranking order, 30 products a page.

### Support

Questions, a site that changed, or a field you need? Open an issue on this Actor's **Issues** tab: we answer there, usually within a day.

***

Also found as: Momo Shopping scraper, momoshop.com.tw scraper, momo購物網, Taiwan e-commerce prices, Taiwan product data.

# Actor input Schema

## `searches` (type: `array`):

Words to search on momoshop.com.tw, one per line, up to 20. Traditional Chinese works best (for example 筆記型電腦 for laptops); English brand and model names also work.

## `maxProductsPerSearch` (type: `integer`):

Up to 500 products for each search (Momo shows 30 a page). A product found by two searches is delivered and charged once.

## `trackPrices` (type: `boolean`):

Compare each product's price with your previous run and fill priceStatus, previousPrice and priceChange. The history is kept in your own Apify key-value store; it is free.

## `trackingName` (type: `string`):

Optional name for a separate price history, for example daily-laptops. Reuse it on later runs to compare with them.

## Actor input object example

```json
{
  "searches": [
    "筆記型電腦"
  ],
  "maxProductsPerSearch": 20,
  "trackPrices": true
}
```

# Actor output Schema

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

Dataset: the results.

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

What each input returned, and notes.

# 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 = {
    "searches": [
        "筆記型電腦"
    ],
    "maxProductsPerSearch": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("niches/momo-shopping-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 = {
    "searches": ["筆記型電腦"],
    "maxProductsPerSearch": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("niches/momo-shopping-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 '{
  "searches": [
    "筆記型電腦"
  ],
  "maxProductsPerSearch": 20
}' |
apify call niches/momo-shopping-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,niches/momo-shopping-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/PcjGldvV89zBT5P1f/builds/H6rvawKTyuBlF29M2/openapi.json
