# 1688 Price Monitor: Track Prices, Stock & Sales (`theshark/1688-price-monitor`) Actor

Track 1688.com products over time: give product links or offer IDs and run on a schedule. Every row shows what changed since the previous run: price, stock, sales, title or availability, with before and after values, plus full product data. Monitoring is free.

- **URL**: https://apify.com/theshark/1688-price-monitor.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

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

## 1688 Price Monitor: Track Prices, Stock and Sales of 1688.com Products

Track products on [1688.com](https://www.1688.com) (Alibaba 1688), China's largest wholesale marketplace. Give product links or offer IDs, run the actor on a schedule, and every run tells you what changed since the previous one: price, stock, sold count, title or availability, with before and after values. Every row also has the full product data: tiered prices, minimum order quantity (MOQ), stock, sales, images, attributes, supplier and shipping.

No 1688 account, login, cookies or proxies of your own are needed. Monitoring is free: you pay only for products that were collected successfully.

### What can you do with 1688 Price Monitor?

- **Watch supplier prices:** know when a supplier raises or lowers the price of the products you buy.
- **Track stock:** see when stock runs low or a product sells out before you place an order.
- **Follow competitors' sources:** watch the sales of products your competitors sell.
- **Catch removed products:** a product that is gone from 1688 is marked `GONE`.
- **Keep a price history:** every run is a dataset, so a schedule gives you the history of every product.

### How does it work?

1. The first run collects every product and marks it `NEW`. Its state (prices, stock, sold count, title, status) is saved in a key-value store in your own Apify account.
2. Every next run with the same **monitor name** compares each product with the saved state and adds a `monitor` object to the row:
   - `NEW`: the product is seen for the first time;
   - `CHANGED`: `changes` lists the price, stock, sold count, title or status that differ, with `before` and `after`;
   - `UNCHANGED`: nothing changed;
   - `GONE`: the product was found last time and is not found now.
3. The saved state is updated at the end of every run.

Set up an Apify schedule (for example every day) with the same input, and look at the **Changes** view of each run, or send the results to Google Sheets, Slack or a webhook.

### How to monitor 1688 prices

1. Paste 1688 product links (`detail.1688.com/offer/<id>.html`) or offer IDs into **Product URLs or offer IDs**.
2. Give your watch list a **monitor name**, for example `my-cases`. Use different names for separate watch lists.
3. Click **Start**, then create a schedule for the same input in **Schedules**.
4. Open the **Changes** view of a run, download the results as JSON, CSV or Excel, or get them through the API.

If you start the actor with an empty input, it runs a small example with two products under the monitor name `example`, so you can see what the data looks like.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `offerIds` | list of strings | empty | 1688 product links or offer IDs, for example `735353578254`. |
| `monitorName` | string | `my-products` | The name of your watch list. Runs with the same name are compared with each other. |
| `includeSkuDetails` | boolean | `false` | Add every variant with its options, price, stock and sales to the row. Variants are not compared. |

#### Example

```json
{ "offerIds": ["735353578254", "https://detail.1688.com/offer/634155097789.html"], "monitorName": "my-cases" }
```

### Output

One dataset row per product with a `monitor` object, shown in the **Changes** view; the **Products** view shows the full product data. Text fields are in the original Chinese, prices are in CNY. Example row (shortened):

```json
{
  "offerId": "735353578254",
  "status": "OK",
  "title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
  "price": { "min": 9, "max": 9, "currency": "CNY", "basis": "quantity" },
  "stock": 2692399,
  "soldCount": 19433,
  "monitor": { "status": "UNCHANGED", "changes": [], "previousScrapedAt": "2026-11-13T12:02:56+00:00" },
  "detailUrl": "https://detail.1688.com/offer/735353578254.html",
  "scrapedAt": "2026-11-13T12:03:55+00:00"
}
```

When something changed, `monitor` lists every change:

```json
"monitor": {
  "status": "CHANGED",
  "changes": [
    { "field": "priceMin", "before": 9, "after": 8.5 },
    { "field": "stock", "before": 2692399, "after": 2650120 }
  ],
  "previousScrapedAt": "2026-11-13T12:03:55+00:00"
}
```

Compared fields: `priceMin` and `priceMax` (the product's price range), `stock`, `soldCount`, `title` and `status`.

### How much does it cost to monitor 1688 products?

Pay per event: a flat price per product. Monitoring itself is free. The current prices are on the **Pricing** tab.

| Event | When it is charged |
|---|---|
| `product` | One product collected from its page (status `OK`). |

Only rows with status `OK` are charged: a `GONE` product costs nothing. Set a maximum charge per run in Apify and the actor stops cleanly when it is reached.

#### Row statuses

| Status | Meaning | Charged? |
|---|---|---|
| `OK` | The product was collected. | Yes |
| `NOT_FOUND` | The product is no longer on 1688 or the ID is wrong. | No |
| `BLOCKED` | 1688 did not show this page this time. `monitor` is `null` and the saved state is kept for the next run. | No |
| `ERROR` | The row could not be collected, for example an invalid link. `statusMessage` says why. | No |

### Good to know

- **Where the state is kept.** In the key-value store `china-1688-monitor-<name>` in your Apify account, record `SNAPSHOT`. The name is lower-cased; use Latin letters and digits, other characters are dropped. Products not seen for 90 days are removed from it.
- **The example has its own monitor.** A run with an empty input uses the monitor name `example`, so it never mixes with your watch lists.
- **Data is in Chinese.** Titles, attributes and supplier names come as 1688 shows them. Prices are in CNY.
- **No contacts.** No phone numbers, emails, WeChat or QQ, or names of company contact persons.
- **Run settings.** Give the run a timeout of at least 5 minutes. The minimum memory is 1024 MB.

### Integrations and API

Start runs and download results with the [Apify API](https://docs.apify.com/api/v2) or the Apify clients for Python and JavaScript, run on a schedule, and send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.

### FAQ

**How often should I run it?**
As often as you want to know about changes: once a day is a good start. Every run costs the same per product.

**Can I monitor a search or a category instead of a product list?**
Yes, with the [1688.com Wholesale Scraper](https://apify.com/TheShark/china-1688-scraper): give keywords or search links and a `monitorName`, and new products and price changes in the results are marked the same way.

**Do I need a 1688 account or proxies?**
No. The actor uses its own proxies in China and does not log in.

**Is it legal to scrape 1688?**
The actor collects only publicly visible product information and no personal data. You are responsible for how you use the data and for following the laws and terms that apply to you.

### More 1688 scrapers

- [1688.com Wholesale Scraper](https://apify.com/TheShark/china-1688-scraper): every mode in one actor.
- [1688 Product Details Scraper](https://apify.com/TheShark/1688-product-details-scraper): full product pages by link or offer ID.
- [1688 Search Results Scraper](https://apify.com/TheShark/1688-search-results-scraper): fast, low-cost product cards by keyword, link or category.
- [1688 Supplier Scraper](https://apify.com/TheShark/1688-supplier-scraper): supplier profiles and their products.
- [1688 Image Search Scraper](https://apify.com/TheShark/1688-image-search-scraper): find products and suppliers by photo.

# Actor input Schema

## `offerIds` (type: `array`):

1688 product links (detail.1688.com/offer/<id>.html) or offer IDs, for example 735353578254.

## `monitorName` (type: `string`):

The name of your watch list. The previous state of every product is kept in a key-value store in your Apify account, china-1688-monitor-<name> (the name is lower-cased; use Latin letters and digits, other characters are dropped). Use the same name on every run to compare with the previous run, and different names for separate watch lists. If empty, my-products is used.

## `includeSkuDetails` (type: `boolean`):

Add the full variant matrix: each variant with its options, price, stock and sales. Variants are only added to the row: the monitor compares the product's price range, stock, sold count, title and status.

## Actor input object example

```json
{
  "monitorName": "my-products",
  "includeSkuDetails": false
}
```

# Actor output Schema

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

One dataset row per product, with its monitor status.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/1688-price-monitor").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("theshark/1688-price-monitor").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 '{}' |
apify call theshark/1688-price-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/1688-price-monitor"
        }
    }
}
```

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/gsdExsajbSOQa6CWr/builds/HZ8NiyTcYW5rkrANu/openapi.json
