# China 1688 Supplier Monitor

> China 1688 Supplier Monitor is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Monitors a 1688.com wholesale supplier offer for price, MOQ, stock, and promotion changes and returns current vs. previous state with a diff of changed fields

## Facts

- Endpoint: POST https://api.timzinin.com/api/china-1688-supplier-monitor
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-1688-supplier-monitor-206c0b46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tptUy4WYW0R1kgcIohWZH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability china-1688-supplier-monitor-206c0b46 -d '<json body>'
```

Example prompt: Check my 1688 supplier watch called 'main-supplier-watch' for offer ID 1000406623486 and tell me if the price, MOQ, or promotions have changed since the last time we checked.

## When to prefer this

Choose this endpoint when you need real-time change detection on a specific 1688.com wholesale offer rather than a broad product search. It is ideal for supply chain agents that need to detect price drift, MOQ changes, or new promotions on a known supplier listing, especially when you already have an offer ID and want a structured diff between current and previous state. It is not suited for discovering new suppliers or searching 1688 by keyword.

## Known failure modes

- Offer ID not found on 1688 — returns found:false with an error message
- Partial data retrieval — partial:true with partialReason explaining what was incomplete
- Network or scrape timeout — run_ms may be high and results may be empty
- Demo mode fallback — isDemo:true if live data unavailable, returning synthetic example data
- Payment not settled — settled:false if x402 micropayment failed

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object with meta (run time, item count, settlement status) and a results array containing the current offer state (price tiers, MOQ, stock, title, supplier details, promotions, currency), the previous snapshot (prior priceMin and offerId), a list of changedFields, a changeType flag, timestamps, and an evidence URL linking directly to the 1688 offer page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "offers": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "offerId",
     "current",
     "sourceName",
     "sourceLicense"
    ],
    "properties": {
     "current": {
      "type": "object",
      "required": [
       "offerId",
       "title",
       "priceMin",
       "priceMax",
       "currency",
       "priceTiers",
       "supplier"
      ],
      "properties": {
       "moq": {
        "type": [
         "number",
         "null"
        ],
        "maximum": 1000000000,
        "minimum": 0
       },
       "unit": {
        "type": [
         "string",
         "null"
        ],
        "pattern": "\\S",
        "maxLength": 120,
        "minLength": 1
       },
       "stock": {
        "type": [
         "number",
         "null"
        ],
        "maximum": 1000000000000,
        "minimum": 0
       },
       "title": {
        "type": "string",
        "pattern": "\\S",
        "maxLength": 500,
        "minLength": 1
       },
       "badges": {
        "type": "array",
        "items": {
         "type": "string",
         "pattern": "\\S",
         "maxLength": 240,
         "minLength": 1
        },
        "maxItems": 30,
        "uniqueItems": true
       },
       "offerId": {
        "type": "string",
        "pattern": "^[0-9]{1,80}$"
       },
       "currency": {
        "type": "string",
        "pattern": "^[A-Za-z]{3}$"
       },
       "priceMax": {
        "type": "number",
        "maximum": 1000000000,
        "minimum": 0
       },
       "priceMin": {
        "type": "number",
        "maximum": 1000000000,
        "minimum": 0
       },
       "supplier": {
        "type": "object",
        "required": [
         "id",
         "name"
        ],
        "properties": {
         "id": {
          "type": "string",
          "pattern": "\\S",
          "maxLength": 180,
          "minLength": 1
         },
         "name": {
          "type": "string",
          "pattern": "\\S",
          "maxLength": 300,
          "minLength": 1
         },
         "loginId": {
          "type": [
           "string",
           "null"
          ],
          "pattern": "\\S",
          "maxLength": 180,
          "minLength": 1
         }
        },
        "additionalProperties": false
       },
       "priceTiers": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "beginAmount",
          "price"
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "error": "",
    "found": true,
    "isDemo": false,
    "source": "1688",
    "current": {
     "moq": 10,
     "unit": "件",
     "stock": 8000,
     "title": "Example wholesale offer",
     "badges": [],
     "offerId": "1000406623486",
     "currency": "CNY",
     "priceMax": 5.2,
     "priceMin": 4.5,
     "supplier": {
      "id": "b2b-example",
      "name": "Example Supplier",
      "loginId": "example"
     },
     "priceTiers": [
      {
       "price": 5.2,
       "beginAmount": 10
      },
      {
       "price": 4.5,
       "beginAmount": 100
      }
     ],
     "promotions": []
    },
    "partial": false,
    "previous": {
     "offerId": "1000406623486",
     "priceMin": 4.8
    },
    "targetId": "1000406623486",
    "checkedAt": "2026-08-06T05:00:00.000Z",
    "targetUrl": "https://detail.1688.com/offer/1000406623486.html",
    "watchName": "main-supplier-watch",
    "changeType": "changed",
    "evidenceUrl": "https://m.1688.com/offer/1000406623486.html",
    "changedFields": [
     "priceMin",
     "priceTiers",
     "promotions"
    ],
    "partialReason": ""
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-1688-supplier-monitor-206c0b46/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)